Web Fetch API

Lexmount Web Fetch 是一个对外公开的网页提取 API，用来抓取页面、按需渲染，并直接返回结构化结果，无需自己搭建 scraping pipeline。

能力概览

• POST /v1/extract：一体化结构化提取
• POST /v1/dom/dump：获取抓取后的 HTML，并复用 DOM 快照
• 支持通过 dom_id 串联抓取和提取链路
• 支持 trace 和 raw_dom 调试字段
• 提供常见 HTTP / API 错误排查说明

鉴权说明

• 外部调用时，请求需要同时带 X-API-Key 和 X-Project-Id
• 在当前站点的 API 密钥设置 创建或复制 API key 与 project id
• COM 项目使用 https://api.lexmount.com，CN 项目使用 https://api.lexmount.cn；凭据必须与 API 区域匹配

从这里开始

• 快速开始 说明第一个请求、返回结构，以及何时使用 dump-dom
• All-in-One Extract 说明 /v1/extract 的完整请求与响应格式
• Dump DOM 说明引擎选择、HTML 抓取和 dom_id 复用
• 常见错误 说明常见接入故障与排查方法

典型调用流程

1. 正常生产调用时，先用 POST /v1/extract，传 extract.url。
2. 如果需要排查链路，再显式打开 trace.include_steps。
3. 如果提取失败，或者要检查实际抓到的 HTML，再调用 POST /v1/dom/dump。
4. 使用返回的 dom_id 再发起 /v1/extract，把抓取问题和提取问题拆开看。

常见输出字段

result 里最常用的字段包括：

• title
• description
• main_text
• final_url
• author
• publish_time
• links
• images
• engine
• dom_id

接入范围与用量

公开 API 提供上面的两个 POST 接口。Web Fetch 面向公开 HTTP/HTTPS 网页，不接管 Cloud Browser 会话的 Cookie、Context 或代理配置。需要登录、点击或访问公司内网时，使用 Cloud Browser；内网访问可用 SDK 本地代理。

两种接口成功完成都会上报 Web Fetch 次数；先 dump 再 extract 是两次调用，复用 dom_id 不代表免计次。用量上报是异步的，超时后不能仅凭客户端未收到响应判断没有计次。套餐内含额度先于已购加量余额扣减；在 方案与用量 查看可用额度，价格见 价格页。

Web Fetch 试验场 可以运行这两个接口。登录后使用自己的项目；启用免登录试用的环境会显示访客次数限制。访客试用不代表公共 API 可以免鉴权调用。

Free 的内含 Web Fetch 额度按同一账号身份关联的项目汇总使用；更换 Key 或删除后重建项目不会重新获得一份免费额度。付费加量余额仍属于购买时选定的项目。