Skip to content

New AI assistant answers: ChatGPT, Gemini, Copilot and AI Mode by API

SerpKite
Get API key

POST /v1/extract · output_schema

Structured data extraction

Stop writing a parser per site. Describe the fields you want as a JSON Schema, send the URLs, and get back JSON that matches it, written by Claude from each page's content.

How it works

Pages and PDFs to JSON that matches your schema.

output_schema on /v1/extract fills your JSON Schema from each page: up to 20 URLs or PDFs per call, fetched in parallel, logged out, with JavaScript pages rendered when needed. An optional prompt says what to pick and how to normalise it. Claude Haiku 5.5 writes the JSON, and values come only from the page.

A schema made only of booleans and enums is a classification, and goes to OpenAI's Decisions API instead, which always answers with a value the schema allows. summary: true adds a short summary of each page (+4 credits).

Each page costs 1 credit plus 4 for the JSON. A page that fails is listed in failed and costs nothing; an extraction that fails is reported in output_error and only the page is billed. Short pages that turn out to be bot checks, login walls or soft 404s are not billed at all.

curl https://api.serpkite.com/v1/extract \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.example.com/pricing"],"output_schema":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"price_per_month":{"type":"number"}}}}}},"prompt":"Monthly prices in USD"}'
results[].output · illustrative
{
  "url": "https://www.example.com/pricing",
  "output": {
    "plans": [
      {
        "name": "Starter",
        "price_per_month": 19
      },
      {
        "name": "Team",
        "price_per_month": 79
      }
    ]
  }
}

What each page can return

What each page can return
OptionReturnsCredits per page
(default)markdown, text or html with metadata1
query + highlightsThe passages that match the query (BM25)1
summary: trueA 3–6 sentence summary1 + 4
output_schema (+ prompt)JSON that matches your schema1 + 4

Why it matters

What you get

01

Your schema, your fields

Up to 16 KB of JSON Schema: nested objects, arrays, enums and nullable fields.

02

Schema-valid classification

Boolean and enum schemas are answered by a decision model that can't step outside the schema.

03

HTML and PDF

Product pages, docs, filings and papers, 20 per call, fetched in parallel.

04

Pay for what worked

Failed pages are free, and a failed extraction costs only the page read.

FAQ

Structured data extraction: common questions

Start building

Get your API key in 30 seconds

2,500 free credits, then 1,000 every month. No credit card.