MCP documentation menu

datapulse_scrape_bulk_results

OtherScope: datapulse:scrapeRead-only

Reads up to 250 stored scrapes by url_hash in one call, such as every sent[].url_hash of a datapulse_scrape_bulk receipt.

Description

Reads up to 250 stored scrapes by url_hash in one call, such as every sent[].url_hash of a datapulse_scrape_bulk receipt.

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.

Paged in url_hashes order: limit default 15, max 30 (larger values are capped), about 2 KB per result. total counts results across all pages; truncated: true with next_offset and a note marks a page that is a SUBSET (pass offset=next_offset with the same url_hashes).

Rows have datapulse_scrape_result’s fields except cleaned_dom, the links array and the per-connection fields (final_url, redirected, tls, quic, server_addr); link_domains and crawler_policies_present are included. not_found lists hashes with no row (a URL still pending is in results) and duplicates lists entries naming a row already asked for (hashes match in any case: index, url_hash, first_index); both come complete on the offset=0 page, and counts gives their sizes on every page. total + counts.not_found + counts.duplicates equals the number of hashes sent.

counts.by_status gives pending, processing, completed and failed (each present, 0 when none) over every result found, on every page, and sums to total. Repeated with backoff on a bulk receipt’s hashes, this call polls the batch: it is finished when pending and processing are both 0.

Reference: datapulse_help(topic="scraping")

Parameters

ParameterTypeDescription
url_hashes
required
string[]
Array of SHA-256 URL hashes to retrieve results for. Maximum 250 per request.
Min items: 1Max items: 250
limitinteger
Results per page. Default 15, max 30 (larger values are capped). Each result is about 2 KB.
offsetinteger
Results to skip, from a previous response’s next_offset. Default 0.
Input schema (JSON)
{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "description": "Results per page. Default 15, max 30 (larger values are capped). Each result is about 2 KB.",
      "type": "integer"
    },
    "offset": {
      "description": "Results to skip, from a previous response's next_offset. Default 0.",
      "type": "integer"
    },
    "url_hashes": {
      "description": "Array of SHA-256 URL hashes to retrieve results for. Maximum 250 per request.",
      "items": {
        "maxLength": 64,
        "minLength": 64,
        "pattern": "^[a-fA-F0-9]{64}$",
        "type": "string"
      },
      "maxItems": 250,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "url_hashes"
  ],
  "type": "object"
}

Generated from the live server (DataPulse MCP v0.9-341-g27163c2) on October 20, 2026.