Batch Export

Create export jobs for many URLs in a single API call — the same "paste a list of URLs" flow exposed in the web dashboard. Each URL becomes an independent job with its own GUID, but they share a batch_id so you can poll a single endpoint for an aggregated status rollup.

When to use this

• Backfilling a list of public posts / videos / reviews you already have collected
• Running the same export options across many sources in one shot
• Avoiding the round-trip and per-job rate-limit windows of submitting URLs one at a time

For downloading the results of multiple completed jobs as a single ZIP, see Bulk Download — that's a different feature.

Workflow

1. Create the batch with an array of URLs and shared options
2. Poll status at the batch endpoint (or any individual /jobs/{guid})
3. Each job's CSV / Excel / JSON download URL is available once that specific job hits done

POST /api/v1/batch-export        → { batch_id, guids: [...], errors: [...] }
GET  /api/v1/batch-export/{id}   → { batch_id, status, total, done, errored, queueing, in_progress }

Endpoints

Plan limits

A request that exceeds the per-plan ceiling returns HTTP 400 with an explanatory message — submit smaller batches or upgrade the plan.