Get Batch Job Status
Poll a batch job and retrieve paginated item results.
GET /v1/batch/{job_id} returns the current status of a batch job and a paginated slice of item results. Use it after creating a batch with Start a Batch Job.
Poll this endpoint until status becomes completed, failed, or cancelled.
Request
Replace the example job ID with the job_id returned by POST /v1/batch.
export SCRAPER_API_BASE_URL="https://scraper.geonode.io"
export GEONODE_SCRAPER_API_KEY="YOUR_API_KEY"
curl "$SCRAPER_API_BASE_URL/v1/batch/9d7b2c8e-8a4b-4c10-9af3-65f4f8f6c019?page=1&page_size=10" \
-H "X-Api-Key: $GEONODE_SCRAPER_API_KEY"Query Parameters
The result list is paginated because batch jobs can contain many URLs.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | 1 | Page of item results to return. |
page_size | integer | No | 10 | Results per page. Must be between 1 and 50. |
Response
The response includes job counters, invalid URLs, usage accounting fields, and the current result slice selected by page and page_size.
{
"job_id": "9d7b2c8e-8a4b-4c10-9af3-65f4f8f6c019",
"status": "processing",
"batch_config": {
"render_js": false,
"formats": ["markdown"],
"proxy": {
"country": "US",
"type": "residential"
},
"headers": null
},
"token_summary": {
"tokens_charged_total": 1,
"tokens_reserved": 1
},
"total_urls": 2,
"completed_urls": 1,
"failed_urls": 0,
"cancelled_urls": 0,
"pending_urls": 1,
"invalid_urls": [],
"created_at": "2026-05-26T10:30:00Z",
"completed_at": null,
"results": [
{
"input_index": 0,
"url": "https://quotes.toscrape.com/",
"status": "completed",
"error_code": null,
"error_message": null,
"data": {
"markdown": "...",
"html": null,
"links": null
},
"metadata": {
"http_status": 200,
"duration_ms": 842,
"retry_count": 0,
"tokens_charged": 1
}
}
]
}batch_config shows the settings applied to every batch item. Each result item can include metadata with HTTP status, duration, retry count, and tokens charged for that item. Completed items include the extracted data; failed items include error_code and error_message instead. The response field names use tokens_charged_total and tokens_reserved; in billing language, treat these as request-count accounting fields.