---
title: "Submit Batch"
method: POST
path: "/api/v1/async/batch"
tags: ["Async Scraping"]
---

# Submit Batch

`POST /api/v1/async/batch`

## Request

- Base URL: `https://api.finedata.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.finedata.ai/api/v1/async/batch`
- Auth: HTTP bearer

Submit up to 100 URLs for parallel async scraping. Returns a `batch_id` to track progress.

## Headers

- `authorization` string, nullable
- `x-api-key` string, nullable

## Request body

- BatchScrapeRequest: Submit multiple URLs for async scraping in a single request.
  - `requests` unknown[], required: Array of scrape requests. Each item supports the same fields as AsyncScrapeRequest (without callback_url)
    - unknown
  - `callback_url` string, nullable: Webhook URL called when all jobs in the batch complete

## Response `200`

Successful Response

- BatchJobResponse: Returned when a batch is created.
  - `batch_id` string, required: Unique batch identifier
  - `job_ids` unknown[], required: List of individual job IDs
    - unknown
  - `total_jobs` integer, required: Number of jobs in the batch
  - `status` string, required: Batch status (initially 'pending')
  - `created_at` string, required: Creation timestamp

## Other responses

- `422`: Validation Error

---

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