Skip to main content
POST

Authentication

Requires x402 payment proof in the X-Payment-Proof header.

Request Body

string
required
URL of the web page to read

Response (202 Accepted)

string
Job ID for tracking progress
string
Job status: processing
string
Always web_read

Job Result (poll /v1/requests/:id)

string
The URL that was read
string
Page content extracted as markdown (max 50KB)
string
Screenshot of the page
object
Page metadata: title, description, statusCode
boolean
Whether the markdown was truncated to 50KB
See Pricing for web read costs.

Notes

  • Content is extracted with only_main_content mode
  • Markdown is truncated to 50KB if the page is very large
  • Screenshots are generated server-side
  • Job results are available via polling at /v1/requests/{request_id}