快速开始

使用 Lexmount Web Fetch API，可以直接从公开网页中提取结构化内容，而不需要自己搭建抓取、渲染和提取链路。

最常用的起点，是 POST /v1/extract。

鉴权说明

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

第一个请求

API_KEY='<your-api-key>'
PROJECT_ID='<your-project-id>'

curl -sS -X POST https://api.lexmount.cn/v1/extract \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $API_KEY" \
  -H "X-Project-Id: $PROJECT_ID" \
  -d '{
    "extract": {
      "url": "https://example.com"
    }
  }'

典型响应：

{
  "request_id": "01964d0f-5f3a-7c3d-8a41-1234567890ab",
  "result": {
    "url": "https://example.com",
    "final_url": "https://example.com",
    "status_code": 200,
    "title": "Example Domain",
    "description": "Example Domain",
    "main_text": "Example Domain This domain is for use in illustrative examples in documents.",
    "engine": "http",
    "dom_id": "123"
  },
  "metadata": {
    "dom_id": "123",
    "server_elapsed_ms": 1234
  }
}

提取服务的 JSON 响应携带顶层 request_id，同一个值也会出现在响应头 X-Request-ID。网关提前拒绝时可能采用其他格式；请同时保存 HTTP 状态、响应头和响应体。

你会拿到什么

POST /v1/extract 是一体化接口，内部会自动完成：

• 页面抓取
• 模板匹配
• 没有匹配模板时的通用提取，以及可用时的后台模板生成
• 最终结构化提取

result 里最常用的字段包括：

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

顶层排查字段：

• request_id

什么时候使用 Dump DOM

当你需要直接拿到抓取后的 HTML、检查页面渲染结果、或者希望复用某次抓取得到的 dom_id 时，使用 POST /v1/dom/dump。

curl -sS -X POST https://api.lexmount.cn/v1/dom/dump \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $API_KEY" \
  -H "X-Project-Id: $PROJECT_ID" \
  -d '{"url":"https://example.com"}' \
  | jq '{final_url, engine, dom_id, html_len:(.html|length)}'

可选调试字段

POST /v1/extract 默认不返回 trace 和 raw_dom。

• 如果你需要查看抽取链路步骤，见 开启 Trace
• 如果你需要在响应中拿到 raw_dom，见 返回 Raw DOM

下一步

• 查看 All-in-One Extract 了解 /v1/extract 的完整请求和响应格式
• 查看 Dump DOM 了解 /v1/dom/dump 的参数与复用方式
• 查看 常见错误 了解常见错误和排查方式

接入时还需要注意

• 示例响应仅展示部分字段。main_text、作者、发布时间、链接和图片可能缺失；HTTP 200 不保证正文完整。请检查业务所需内容。
• 没有匹配模板时会尝试通用提取；后台模板生成并不表示当前请求会等待新模板完成。
• 引擎和 User-Agent 位于 extract.options，见 请求参数。/v1/dom/dump 则使用顶层 options。
• 处理错误时先检查 HTTP 状态，再兼容 error 对象、error 字符串和 message。鉴权/额度网关提前拒绝时可能没有 JSON request_id；保存响应头和原始响应体。详见 常见错误。
• 在自己的服务端调用 API。公共入口的浏览器 CORS 配置面向 Lexmount 控制台，不应把项目密钥嵌入公开网页并依赖任意来源的跨域请求。

在试验场体验

选择 Extract 或 Dump DOM，输入 URL 后运行请求。可查看响应或复制生成的 cURL 命令；重置会恢复示例 URL 和请求设置。此试验场不提供浏览器引擎选择。

返回控制台