Data APIGET /v1/data/{source}

Pages in, records out.

The Data API turns a product page, an article or any page's head into a record with fixed fields. Deterministic parsers read the structured data the page already has, so the same page gives the same record every time.

What it does

Products, articles and page metadata as records with fixed fields.

  • Products

    Name, brand, SKU, GTIN, images, offers with normalized prices and availability, and the aggregate rating.

  • Articles

    Title, byline names, dates, publisher, language and the body as Markdown, without navigation, sidebars or comments.

  • Metadata

    Title, description, canonical URL, Open Graph, Twitter cards, JSON-LD, feeds and alternates from the page's head.

  • Deterministic parsers

    JSON-LD first, then microdata, Open Graph and HTML. parser says which one produced the record.

  • No personal data

    There are no connectors for people or profiles. Reviews, emails, phone numbers and addresses are left out.

  • The Scraper API underneath

    Pages are fetched with the same proxies, tiers and retries. render and country work as for a scrape.

Example

One HTTP call

Pick a source (product, article or metadata) and pass a URL, as a GET query or a POST body.

Official SDKs are coming soon. Until then, any HTTP client works.

Data API docs
curl -G https://api.siftzo.com/v1/data/product \
  -H "X-API-Key: $SIFTZO_API_KEY" \
  --data-urlencode "url=https://shop.example/p/1"

Reference

Key parameters

sourceproduct | article | metadatarequired
In the path: /v1/data/{source}.
urlstringrequired
The page to read.
renderauto | never | alwaysdefault auto
How the page is fetched, as for the Scraper API.
countryISO 3166-1 alpha-2
Exit country.
timeout_msintegerdefault 30000
5,000–50,000, for the whole request.
llm_fallbackbooleandefault false
product and article: when the parsers find nothing, run AI extraction with a fixed schema.

Every parameter and response field is in the Data API docs.

Credits

What it costs

Data API credits
RequestCredits
Data API recordsame as a scrape of the tier that fetched the page; the AI fallback adds extraction credits
HTTP request (render=never)1
Browser request (render=always, or auto when needed)10
AI extractionscrape credits + LLM tokens: ⌈(input × 2 + output × 10) / 300⌉ with the default model

A page with nothing to parse returns found: false and is billed like the scrape it took.

See plans

Questions

What if a page has no structured data?

The parsers fall back to Open Graph and the HTML itself. If they still find nothing, the answer has found: false and record: null. With llm_fallback: true (products and articles), AI extraction reads the page with a fixed schema instead, priced as an extraction.

Is the same page always parsed the same way?

Yes. The parsers are code, not a model, so the same HTML gives the same record. The parser field says which one was used.

How are prices normalized?

As a decimal string with a currency code, for example 1.299,00 € becomes "1299.00" and EUR. Availability becomes one of a fixed set of values such as in_stock or out_of_stock.

Can it collect people's data?

No. There are no sources for people or profiles, reviews are never included, and contact details are removed from metadata. See Responsible use.

Try the Data API for free

Create an account, copy your key and send a request. No card needed for the Free plan.