List scraper result records
Changed onReturns stored JSON Records for a completed scraper Request.
Request
- Base URLhttps://api.tovuk.com
- AuthHTTP bearer
Path parameters
Scraper Request id. Context $.paths./v1/requests/{request_id}/results.get.parameters.0.
Query parameters
Maximum number of items to return. Context $.paths./v1/requests/{request_id}/results.get.parameters.1.
Opaque pagination cursor from a previous response. Context $.paths./v1/requests/{request_id}/results.get.parameters.2.
Response
Scraper results 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"
},
"records": [
{
"index": 0,
"data": {
"id": "video_123",
"desc": "rust programming"
},
"sizeBytes": 64,
"createdAt": "2026-06-23T12:00:30Z"
}
],
"nextCursor": null,
"nextActions": [
"Use `nextCursor` with `tovuk request results request_123 --cursor <nextCursor> --json` when another page exists."
]
}Changes
- breaking
removed the required property
from the response with the status - breaking
removed the required property
//from the response with the status - warning
changed the pattern of the
queryrequest parametercursorfrom^[\s\S]{0,8192}$to^[\s\S]{1,512}$ - info
added the required property
to the response with the status - info
added the required property
//to the response with the status - info
added the required property
//to the response with the status - info
added the required property
to the response with the status
- breaking
- info
endpoint added
- info