v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-056151218.0 KB

Extract

JSON

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

post/extract/json

Request body

effort'min' | 'standard' | 'max'

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).

json_schemaobject required

JSON schema definition that describes the structure of data to extract.

nocacheboolean

Bypass cache and force fresh data retrieval

urlstring uri required

URL to fetch and extract data from

Example request

{
  "effort": "standard",
  "geo_target": {
    "country": "US"
  },
  "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"
}

Response

V1ExtractJSONResponse required