MCP documentation menu

datapulse_scrape_result

OtherScope: datapulse:scrapeRead-only

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 …

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

ParameterTypeDescription
url_hash
required
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_domboolean
Include the cleaned HTML DOM, 40 KB per part (up to 200 KB in all). Default false.
Default: false
link_datastring
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: 7
nonedomainslinksboth
links_offsetinteger
With link_data links or both: the first links record to return, from links_next_offset. Default 0.
text_offsetinteger
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.