datapulse_scrape_result
datapulse:scrapeRead-onlyReads one stored scrape by url_hash: poll an asynchronous submission, or fetch the page’s DOM or full links array. A bulk submission’s …
Description
Reads one stored scrape by url_hash: poll an asynchronous submission, or fetch the page’s DOM or full links array. A bulk submission’s results are read together, with their counts by status, by datapulse_scrape_bulk_results.
Scrapes are public by design: each is a fetch of a public web page, kept in one cache shared by all users, so every result is readable by every user.
status: pending or processing (not finished; a later read with backoff returns it, and a bulk URL can stay pending for hours without having failed), completed, or failed (error says why). The row carries url, final_url, redirected, redirect_chain (the main-frame navigation the browser followed, hop by hop), tls, quic, server_addr, timings, extraction, crawler_policies and link_domains.
include_dom=true adds the cleaned DOM 40 KB per part: cleaned_dom_total, and next_text_offset to pass as text_offset. link_data: none, domains (link_domains, the default), links (the links array, 300 records per page: links_total, links_truncated, links_next_offset to pass as links_offset) or both. A note names the call for the next part.
A hash with no stored row answers found: false with a note.
Reference: datapulse_help(topic="scraping")
Parameters
| Parameter | Type | Description |
|---|---|---|
url_hashrequired | string | The url_hash from a submit receipt or a bulk receipt’s sent[].url_hash. Min length: 64Max length: 64Pattern: ^[a-fA-F0-9]{64}$ |
include_dom | boolean | Include the cleaned HTML DOM, 40 KB per part (up to 200 KB in all). Default false. Default: false |
link_data | string | Which link structures the result carries: none, domains (link_domains; the default), links (the links array, 300 records per page) or both. Default: "domains"Max length: 7nonedomainslinksboth |
links_offset | integer | With link_data links or both: the first links record to return, from links_next_offset. Default 0. |
text_offset | integer | With include_dom=true: the byte offset of the DOM part to return, from a previous response’s next_text_offset. Default 0. |
Input schema (JSON)
{
"additionalProperties": false,
"properties": {
"include_dom": {
"default": false,
"description": "Include the cleaned HTML DOM, 40 KB per part (up to 200 KB in all). Default false.",
"type": "boolean"
},
"link_data": {
"default": "domains",
"description": "Which link structures the result carries: none, domains (link_domains; the default), links (the links array, 300 records per page) or both.",
"enum": [
"none",
"domains",
"links",
"both"
],
"maxLength": 7,
"type": "string"
},
"links_offset": {
"description": "With link_data links or both: the first links record to return, from links_next_offset. Default 0.",
"type": "integer"
},
"text_offset": {
"description": "With include_dom=true: the byte offset of the DOM part to return, from a previous response's next_text_offset. Default 0.",
"type": "integer"
},
"url_hash": {
"description": "The url_hash from a submit receipt or a bulk receipt's sent[].url_hash.",
"maxLength": 64,
"minLength": 64,
"pattern": "^[a-fA-F0-9]{64}$",
"type": "string"
}
},
"required": [
"url_hash"
],
"type": "object"
}Generated from the live server (DataPulse MCP v0.9-341-g27163c2) on October 20, 2026.