Scrapers
Get scraper request
Returns current status for a scraper Request.
get/v1/requests/{request_id}
Path parameters
request_idstring required
Example:request_123
Scraper Request id.
Response
Scraper request loaded.
Example response
{
"request": {
"id": "request_123",
"scraper": "tiktok",
"status": "succeeded",
"input": {
"operation": "search",
"query": "rust programming",
"limit": 100
},
"resultCount": 1,
"estimatedCostUsdMicros": 170000,
"costUsdMicros": 1700,
"resultsUrl": "/v1/requests/request_123/results",
"errorMessage": null,
"agentInstruction": "Fetch results with `tovuk request results request_123 --json`.",
"createdAt": "2026-06-23T12:00:00Z",
"updatedAt": "2026-06-23T12:00:30Z"
},
"nextActions": [
"Use `tovuk request results request_123 --json` after the request succeeds."
]
}