Agentic Platform
Tools
Get the HTML SpeedWorkers stored for a URL during a past indexation.
Get what Botify SpeedWorkers stored during one past indexation of a page: the HTML received (and rendered) from the origin, the URL fetched, the HTTP status code and headers returned by the origin, the canonical URL, a summary of the JavaScript rendering, and the indexation job (cache behavior, rendering config, inventory sources and page properties). The indexation event is identified by the `event_id` returned by `speedworkers_page_history`. Old events may no longer be available. Use `speedworkers_page_preview` for the page currently delivered to bots. Header values that may hold credentials (cookies, authorization...) and credentials in URLs are masked. With `save_to_tmp_storage`, the HTML is saved to temporary storage and its URL is returned instead. The project must have SpeedWorkers enabled.
Log in Log in to try this tool. The request uses your session.
event_id
required
The `event_id` of an indexation event, as returned by the `speedworkers_page_history` tool.
save_to_tmp_storage
Save the HTML to Botify temporary storage and return the temporary URL instead of the HTML. Use this to save output tokens. The returned URL can be passed to other HTML-processing tools. Headers and details are still returned.
Fixed cost per indexation event requested. This tool reads the page SpeedWorkers already stored for your project and calls no outside service, so nothing is added to the per-call price.
These usage SKUs can be charged on a call.
| SKU | Credits | Description |
|---|---|---|
| Tool call | 1 per request | Charged once per successful item. |
item is what you send, config how the tool behaves,
and the response is what you get back.
event_id
string
required
The `event_id` of an indexation event, as returned by the `speedworkers_page_history` tool.
{
"event_id": "string"
}save_to_tmp_storage
boolean
Save the HTML to Botify temporary storage and return the temporary URL instead of the HTML. Use this to save output tokens. The returned URL can be passed to other HTML-processing tools. Headers and details are still returned.
{
"save_to_tmp_storage": false
}html
string | null
HTML of the page as stored by SpeedWorkers during this indexation. Omitted when `save_to_tmp_storage` is True; see `html_tmp_storage_url` instead.
html_tmp_storage_url
string | null
Temporary storage URL of the HTML page. Returned instead of `html` when `save_to_tmp_storage` is True. Can be passed to other HTML-processing tools.
url
string | null
URL fetched by SpeedWorkers from the origin
indexed_at
string (date-time)
required
When the indexation happened
status_code
integer | null
HTTP status code returned by the origin
headers
object | null
HTTP headers returned by the origin; values that may hold credentials (cookies, authorization...) are masked with `**`
canonical
SpeedWorkersCanonical
Canonical URL found in the page
js_rendering
SpeedWorkersJsRendering
Summary of the JavaScript rendering
job
SpeedWorkersIndexationJob
Indexation job: cache behavior, rendering config, inventory sources and page properties
reason
string | null
Why no HTML was returned, if any
{
"html": null,
"html_tmp_storage_url": null,
"url": null,
"indexed_at": "string",
"status_code": null,
"headers": null,
"canonical": null,
"js_rendering": null,
"job": null,
"reason": null
}These are the available sub-object types that can be used in the properties above.
SpeedWorkersCanonical
object
has_canonical
boolean | null
Whether the page declares a canonical URL
canonical_url
string | null
Canonical URL declared by the page
canonical_equal
boolean | null
Whether the canonical URL is the page URL
SpeedWorkersIndexationJob
object
section_id
string | null
ID of the matching cache behavior (section)
config_id
string | null
ID of the rendering config used
config_type
string | null
Type of the rendering config (device)
input_ids
array
IDs of the inventory sources of the page
page_properties
array
Page properties at the time of the indexation
status_code
integer | null
Status code of the page known before the job
previous_status_code
integer | null
Previous status code of the page
batch_date
string | null
Date of the indexation batch
SpeedWorkersJsRendering
object
device
string | null
Rendering device
rendered
boolean | null
Whether the page was rendered with JavaScript
status
string | null
Rendering status
redirect_url
string | null
Redirect target found during the rendering
version_code
string | null
Version of the rendering engine
rendering_time_ms
integer | null
Rendering time, in ms
nb_resources
integer | null
Number of resources requested by the page
nb_resources_error
integer | null
Number of resources that failed to load
SpeedWorkersPageProperty
object
input
string | null
ID of the inventory source of the property
name
string | null
Property name
value
string | null
Property value
http://agents.botify.com/{organization}/{project}/speedworkers_page_snapshot/process
http://agents.botify.com/{organization}/{project}/speedworkers_page_snapshot/batch_process
http://agents.botify.com/{organization}/{project}/speedworkers_page_snapshot/async_process
http://agents.botify.com/{organization}/{project}/speedworkers_page_snapshot/async_batch_process
See running a long job in the background for the polling flow.
curl -X POST "http://agents.botify.com/{organization}/{project}/speedworkers_page_snapshot/process" \
-H "Authorization: Bearer $BOTIFY_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"item": {
"event_id": "<event_id>"
}
}'
This tool is exposed as the MCP tool speedworkers_page_snapshot. An MCP client passes
organization, project and item as tool arguments.
Set up MCP →