Polls the status of a previously submitted batch scrape job. Results are retrieved from the webapp's persistent storage.

GET

https://api.scrapingduck.com/v1/scrape/batch/{batchId}

Last modified:2026-10-04 11:19:25

Request

Authorization

API Key

Add parameter in query

apiKey

Example:

apiKey: ********************

Path Params

Query Params

Responses

🟢200

application/json

Body

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.scrapingduck.com/v1/scrape/batch/?includeResults=&page=&pageSize=&onlyFailed=&apiKey=%3Capi-key%3E'

Response Example

200 - Success

{
    "batchId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "completed",
    "totalUrls": 3,
    "succeededCount": 3,
    "failedCount": 0,
    "results": [
        {
            "url": "https://example.com/page1",
            "success": true,
            "statusCode": 200,
            "html": "<!doctype html>...",
            "title": "Page 1",
            "contentLength": 45678,
            "durationMs": 1200
        }
    ],
    "meta": {
        "totalDurationMs": 4500,
        "totalCostCredits": 9,
        "startedAtUtc": "2025-01-01T12:00:00Z",
        "finishedAtUtc": "2025-01-01T12:00:04Z"
    }
}

Modified at 2026-10-04 11:19:25

Submits a batch of URLs for asynchronous scraping. Returns 202 Accepted with a batch ID immediately. Results are delivered via webhook callback or polled via GET /v1/scrape/batch/{batchId}.

Estimates the credit cost of a browser automation request without executing it.