Scrape and parse (POST)
POST /v1/scrape/{parserId}
Fetch one URL and extract it with an owned parser. Sync calls time out after 120 seconds. Set async=1/true (or POST async: true) to submit queue-backed work and receive 202 with job and batch IDs. POST can write rows to a database sink instead of returning extracted data.
Credits: default fetch 1, default browser 5, high-quality fetch 10, high-quality browser 25, hardcore 80. Invalid/private target URLs return 422. A class concurrency cap returns 429 with code concurrency_limited.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Your parser ID from the dashboard.
Request Body required
Section titled “Request Body required ”object
Return data or write rows to an owned database.
object
Upsert key columns; defaults to _url for parser jobs.
Responses
Section titled “ Responses ”Extracted structured data.
Extracted data matching your parser schema.
object
Headers
Section titled “Headers ”Credits consumed by this request.
Remaining credit balance.
Asynchronous job accepted.
object
Return data or write rows to an owned database.
object
Upsert key columns; defaults to _url for parser jobs.
Missing URL or parser ID.
Missing or invalid API key.
object
Example
invalid requestField that failed validation.
Insufficient unreserved credits.
object
Example
insufficient creditsResource missing or not owned by this account.
object
Example
invalid requestField that failed validation.
Validation failed.
object
Example
invalid requestField that failed validation.
Request, concurrency, or plan limit exceeded.
Headers
Section titled “Headers ”Seconds to wait when supplied.
Failed to fetch content from target URL.