---
title: "Batch scrape"
method: POST
path: "/batch/scrape"
---

# Batch scrape

`POST /batch/scrape`

## Request

- Base URL: `https://fastcrawl.net/api/v1`
- URL: `https://fastcrawl.net/api/v1/batch/scrape`
- Auth: HTTP bearer

Up to 50 URLs, 10-wide parallel, same pipeline as /scrape (formats, cache, PDF auto-route, changeTracking). Plan limits checked once up front. Failed requests are never charged.

## Request body

- object
  - `urls` string[], required
  - `formats` string[]: Output formats. changeTracking adds metadata.change_information: {change_status: first|unchanged|added|removed|different, diff} vs your previous scrape of this URL.
  - `maxAge` integer
  - `timeout` integer: Per-page timeout in seconds (5-30, default 30), applied to each URL in the batch.
  - `fetchMode` 'auto' | 'http'

## Response `200`

Per-item results (aligned to input order) + totals.

- object
  - `success` boolean
  - `total` integer
  - `succeeded` integer
  - `failed` integer
  - `results` object[]
    - `success` boolean
    - `url` string
    - `markdown` string
    - `html` string
    - `links` string[]
    - `json` object
    - `metadata` object: incl. change_information when formats has changeTracking; parser=pdf-inspector for PDFs
    - `duration_ms` integer
    - `from_cache` boolean
    - `error` string
    - `error_code` 'target_dns_error' | 'target_unreachable' | 'target_timeout' | 'target_tls_error' | 'target_redirect_loop' | 'target_blocked' | 'target_not_found' | 'target_rate_limited' | 'target_server_error' | 'scrape_http_status' | 'scrape_invalid_url' | 'scrape_engine_error' | 'scrape_antibot_error' | 'scrape_pdf_detected' | 'unknown_format' | 'invalid_request' | 'invalid_api_key' | 'missing_api_key' | 'monthly_limit' | 'daily_limit' | 'rate_limit'
    - `retryable` boolean: true: timeout/unreachable/rate-limit/engine errors — retry helps. false: dns/404/blocked/tls/redirect-loop — do not retry.

---

[API](https://skmtc.dev/fastcrawl/apis/fastcrawl-api.md) · [All operations](https://skmtc.dev/fastcrawl/apis/fastcrawl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fastcrawl/apis/fastcrawl-api/revisions/83951a14d005?raw)