v1

latestOpenAPI 3.1.02026-07-136138.4 KB
Batch
Extract

Batch Extract Multiple Pages

Extract structured data from multiple URLs simultaneously using AI.

Use Cases:

  • Scrape product catalogs from multiple pages
  • Extract data from search result pages
  • Batch process listings or directory pages
  • Collect competitive intelligence at scale

How It Works:

  1. Submit up to 50 URLs with a single schema
  2. Get immediate job ID response
  3. All URLs are extracted using the same schema
  4. Poll for status or receive webhook notification
  5. Retrieve all structured results at once

Features:

  • Same schema applied to all URLs
  • Parallel processing for speed
  • Individual error handling per URL
  • Webhook notifications available
post/extract/batch

Request body

urlsstring[] required

List of URLs to extract data from, maximum 50

schemaobject required

Data structure definition in JSON Schema format

timeoutnumber

Timeout per request in milliseconds, default 30000

Example request

{
  "urls": [
    "https://example.com/product/1",
    "https://example.com/product/2",
    "https://example.com/product/3"
  ],
  "schema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string"
      },
      "price": {
        "type": "number"
      },
      "rating": {
        "type": "number"
      }
    }
  }
}

Response

Success response

successboolean

Example response

{
  "success": true,
  "data": {
    "id": "batch_ext_xyz789",
    "status": "processing",
    "total": 3
  }
}