datapulse_scrape_bulk_results
datapulse:scrapeRead-onlyReads 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
| Parameter | Type | Description |
|---|---|---|
url_hashesrequired | string[] | Array of SHA-256 URL hashes to retrieve results for. Maximum 250 per request. Min items: 1Max items: 250 |
limit | integer | Results per page. Default 15, max 30 (larger values are capped). Each result is about 2 KB. |
offset | integer | 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.