TOtovuk
Scrapers

List scraper requests

Changed on

Lists recent paid scraper Requests for the authenticated account.

get/v1/requests

Request

  • Base URL
    https://api.tovuk.com
  • Auth
    HTTP bearer

Query parameters

limitinteger
Example:50

Maximum number of scraper Requests to return. Context $.paths./v1/requests.get.parameters.0.

cursorstring
Example:example

Opaque pagination cursor from a previous response. Context $.paths./v1/requests.get.parameters.1.

Response

Scraper requests loaded.

nextCursorstring nullable required
nextActionsstring[] required

Example response

{
  "requests": [
    {
      "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"
    }
  ],
  "nextCursor": null,
  "nextActions": [
    "Use `nextCursor` with `tovuk request list --cursor <nextCursor> --json` when another page exists."
  ]
}

Changes

  • c7b37eaf7c38Revision changes
    • breaking

      for the query request parameter limit, default value was changed from 100 to 50

    • breaking

      for the query request parameter limit, the max was decreased from 1000.00 to 200.00

    • breaking

      removed the required property from the response with the status

    • warning

      changed the pattern of the query request parameter cursor from ^[\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

    • 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

  • 3985c6090c91Revision changes
    • info

      endpoint added