Extract

Extract JSON

POST
/extract/json

Fetches a URL and extracts structured data according to a provided JSON schema

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token for API authentication

In: header

Request Body

application/json

Request body

effort?string

Fetch effort level controlling speed vs. capability tradeoff. "min": fastest, no fallback (1-5s). "standard": balanced with enhanced reliability (default, 3-15s). "max": full browser rendering for JS-heavy sites (15-60s).

Default"standard"

Value in

  • "min"
  • "standard"
  • "max"
geo_target?

Optional geotargeting parameters for proxy requests

json_schema*

JSON schema definition that describes the structure of data to extract. If the schema includes a "page_title" or "favicon" property, those fields are automatically filled from page metadata when the AI leaves them empty.

nocache?boolean

Bypass cache and force fresh data retrieval

Defaultfalse
url*string

URL to fetch and extract data from

Formaturi

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/extract/json" \  -H "Content-Type: application/json" \  -d '{    "json_schema": {      "properties": {        "stories": {          "items": {            "properties": {              "author": {                "description": "Author username",                "type": "string"              },              "points": {                "description": "Story points",                "type": "number"              },              "title": {                "description": "Story title",                "type": "string"              }            },            "type": "object"          },          "type": "array"        }      },      "type": "object"    },    "url": "https://news.ycombinator.com"  }'
{}