WebFetch APIReference
All-in-One Extract
Full request and response reference for POST /v1/extract.
POST /v1/extract
Use this endpoint when you want a single request to fetch a page and return structured output.
Authentication
- The API is currently in internal testing
- External requests must include both
X-API-KeyandX-Project-Id - Create or copy them from https://browser.lexmount.cn/settings/api-keys
- For overseas access, use https://browser.lexmount.com/settings/api-keys and replace the endpoint with
https://api.lexmount.com
Request Body
{
"extract": {
"url": "https://example.com"
}
}Fields
| Field | Type | Required | Description |
|---|---|---|---|
extract | object | Yes | Main extraction request |
extract.url | string | No | Target page URL |
extract.dom_id | string | No | Existing DOM snapshot ID |
trace.include_steps | bool | No | Return workflow steps when set to true |
trace.include_raw_dom | bool | No | Return raw DOM when set to true |
Rules:
- At least one of
extract.urlorextract.dom_idis required - Set
trace.include_steps=truewhen you need workflow diagnostics
Minimal Example
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://mp.weixin.qq.com/s/H8Nnk6HEKlwDREmxdjsXSg"}}'Response Shape
Top-level response fields:
| Field | Description |
|---|---|
request_id | Request correlation ID. Also returned in the X-Request-ID response header |
result | Structured extraction result on success |
metadata | Extra metadata such as dom_id and server_elapsed_ms |
error | Error object on failure |
trace | Workflow trace steps; returned only when include_steps=true |
raw_dom | Raw DOM content; returned only when include_raw_dom=true |
Use request_id when you need to report a problem or correlate a client-side response with server-side request logs.
Common fields inside result:
urlfinal_urlstatus_codetitledescriptionmain_textpublish_timeauthorlanguagelinksimagesenginedom_id
Reuse an Existing dom_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": {
"dom_id": "123"
}
}'Enable Trace
By default, POST /v1/extract does not return trace.
To inspect workflow diagnostics, explicitly enable it:
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"
},
"trace": {
"include_steps": true
}
}'Return Raw DOM
By default, raw_dom is not returned.
Enable it only when you actually need the captured DOM in the response:
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"
},
"trace": {
"include_raw_dom": true
}
}'raw_domcan be very large and is not recommended for normal production calls
Debug Mode
Turn on both debug fields only when you need to inspect the workflow and the captured page:
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"
},
"trace": {
"include_steps": true,
"include_raw_dom": true
}
}'tracemakes responses largerraw_domcan be very large and is not recommended for normal production calls
For common failures, see Common Errors.
Lexmount Docs