Skip to content

Parse uploaded HTML (legacy companion)

POST
/v1/parse/{parserId}

Parse HTML you already have with a stored parser. This remains available for compatibility but is not the parser authoring path and does not return v2 dry-run diagnostics. New integrations should create with POST /v1/parsers, validate with POST /v1/parsers/test, and execute with scrape or batches. Limits: 16 MB HTML, 64 MB request.

parserId
required
string

Your parser ID from the dashboard.

object
html
required

HTML content to parse.

string format: binary

Extracted structured data. Shape depends on your parser schema.

Extracted data matching your parser schema.

object

Invalid request (missing html part, malformed HTML).

Missing or invalid API key.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

Resource missing or not owned by this account.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

HTML content exceeds 16 MB limit.

Failed to extract data from the HTML.

Request, concurrency, or plan limit exceeded.

One of:
object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string
Retry-After
integer

Seconds to wait when supplied.