Skip to main content
POST
From 1 credit See the guide for examples and usage.

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <API_KEY>. Keys have full access unless restricted to scopes.

Body

application/json
url
string<uri>
required

Public HTTP or HTTPS URL to scrape.

Pattern: ^https?://
formats
object
required

Outputs to return. Set at least one to true.

markdownParams
object

Markdown options. Requires formats.markdown.

screenshotParams
object

Screenshot options. Requires formats.screenshot: true.

imageParams
object

Image options. Requires formats.images: true.

parseParams
object

Requires formats.parse: true; required when it is set.

highlightsParams
object

Requires formats.highlights: true; required when it is set.

jsonParams
object

Requires formats.json: true; required when it is set.

productParams
object

Product options. Requires formats.product: true.

sharedParams
object

Browser and content settings shared by all outputs.

maxAgeMs
integer
default:259200000

Maximum age of a cached output, in milliseconds. 0 fetches fresh. Defaults to 3 days (259200000 ms). Maximum: 1 year (31536000000 ms).

Required range: 0 <= x <= 31536000000
zdr
enum<string>
default:disabled

enabled turns on zero data retention. Your organization must have ZDR enabled.

Available options:
enabled,
disabled
timeoutOpts
object

Deadline for the whole request. Defaults to 90000 ms with fail. Fixed waits must end before it.

tags
string[]

Labels for tracking request usage. Not retained when zdr is enabled.

Maximum array length: 20
Required string length: 1 - 50
Example:

Response

Every output key is present; check each output's success. Failed outputs include error_code and message.

url
string<uri>
required

Final URL after redirects and browser actions.

Pattern: ^https?://
html
object
required

Rendered HTML after content filters.

markdown
object
required

Markdown after content filters.

screenshot
object
required

Screenshot as a base64 image data URL.

images
object
required

Images after content filters. [] when none are found.

bytes
object
required

The original HTTP response body, unchanged by waits, actions, and filters.

parsed
object
required

Fields from parseParams.rules, after content filters. Unmatched fields are null ([] for lists).

highlights
object
required

Relevant Markdown excerpts in page order. [Heading] adds context; … marks omitted text.

metadata
object
required

Page metadata. Fields are omitted when not found.

cache_metadata
object
required

Whether this response came from cache.

request_id
string<uuid>
required

Unique ID of this request, also in X-Request-Id. Include it when contacting support.

Example:

"3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"

json
object
required

Object matching jsonParams.schema.

product
object
required

Product details found on the page.

isPartial
boolean

True when at least one requested output succeeds but the response has failed or incomplete outputs. Absent when all requested outputs fail.

key_metadata
object

Credits this request used and your remaining balance.