Data API / Firecrawl / Batch Scrape

Poll a batch scrape job.

Fetch a batch scrape job submitted by post_firecrawl_batch_scrape, by its jobId. Returns the same envelope — id, status, createdAt, completedAt, pricing, output, error. Repeat until status is terminal; on success output is an array of documents with markdown and metadata. Reads a job only; it cannot start one.

Parameters

path

jobIdstringRequired
The job id returned by the submit call.

Example request

curl -X GET "https://openapi.felo.ai/v1/beta/firecrawl/batch-scrape/{jobId}" \
  -H "Authorization: Bearer $FELO_API_KEY"

Response

Response fields

idstringOptional
Job identifier. Use it with the corresponding Felo polling endpoint.
objectstringOptional
Always "integration_async_job".
endpointstringOptional
Provider operation identifier stored with the job. This metadata is not a Felo polling URL; use the documented Felo job path or Location header.
statusstringOptional
Allowed values: queued · running · completed · failed · cancelled
Customer-facing lifecycle status. queued and running are non-terminal; completed, failed, and cancelled are terminal.
createdAtstringOptional
When the job was accepted.
completedAtOptional
When the job reached a terminal status. Null while the job is still queued or running.
pricingobjectOptional
currencystringOptional
authorizedMicrosUSDintegerOptional
Provider authorization metadata in micro-USD. This is not a Felo credit hold or billing record.
finalMicrosUSDOptional
Provider settlement metadata in micro-USD, nullable before settlement. This is not the Felo charge.
billingModestringOptional
Provider job billing mode. Felo charges follow Felo billing records.
outputOptional
Job result payload. Present only once status is completed. For Agent Runs this is the structured research result.
outputExpiredbooleanOptional
True when the result has been retained past its retention window and is no longer retrievable.
errorOptional
Present when status is failed. Null otherwise.