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}.

POST

https://api.scrapingduck.com/v1/scrape/batch

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

All URLs in the batch share a single browser context for efficiency. Each URL is processed
with VisitUrlAction + GetHtmlAction in sequence. Credits are reserved when the batch is accepted.

Example Request:

    POST /v1/scrape/batch?disableJavaScript=true
    {
      "urls": [
        "https://example.com/page1",
        "https://example.com/page2"
      ]
    }

Possible error codes:

400 (validation_error): Too many URLs or invalid request body.

401 (unauthorized): The API key is missing or invalid.

402 (payment_required): Insufficient credits for the requested batch.

Request

Authorization

API Key

Add parameter in query

apiKey

Example:

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

Query Params

Body Params

application/json

Examples

Responses

🟢202

application/json

Accepted

Body

🟠400

🟠401

🟠402

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.scrapingduck.com/v1/scrape/batch?deviceName=&locale=&timezone=&disableResourceExclusion=&useAdvancedSpoofing=&disableJavaScript=&useResidentialProxy=&apiKey=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{
    "urls": [
        "https://example.com/page1",
        "https://example.com/page2"
    ]
}'

Response Example

202 - Success

{
    "batchId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "totalUrls": 3,
    "estimatedCost": 9,
    "availableCredits": 500,
    "statusUrl": "/v1/scrape/batch/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

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

Captures a screenshot of a web page as a binary image.

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