Skip to content

The customer contract

Know what you asked for. Understand what came back.

Contrie turns a source into data an application can inspect, with a clear acceptance decision, useful evidence and accountable usage.

  1. 01Source + requested fields

    requestJSON Schema

    url
    en.wikipedia.org/wiki/List_of_tallest_buildings
    extract
    The five tallest buildings in rank order, with city, country, height in metres, floors and year completed
    schema
    • rank
    • name
    • city
    • country
    • height_m
    • floors
    • year
  2. 02Request progress

    loadingprocessingcomplete4.7 s
  3. 03Result + evidence + credits

    resultaccepted

    data.buildings
    5 items
    valid
    true
    qualityScore
    100
    requestedFields
    35 of 35
    groundingCoverage
    35 of 35
    fetchedAt
    credits
    1
A recorded production run, 2026-09-23: read a table, 4.7 s, 1 credit. It does not fetch the current page.

01

Your source and request

Send one public URL or HTML you are authorized to use. Describe the information you need or provide a supported JSON Schema. Choose markdown when you need readable page content instead of structured fields.

POST /api/v1/scrapeJSON Schema

url
https://arxiv.org/abs/1602.03837
extract
The citation details of this paper: title, authors, submission date, journal reference, DOI and primary subject
schema
  • titlestring
  • authorsstring[]
  • submittedstring
  • journal_referencestring | null
  • doistring | null
  • primary_subjectstring

Recorded 2026-09-21 · cite a paper

02

Clear request progress

Live requests report loading, processing and completion. Check the final acceptance decision before using the data. Completion means the request ended; it does not necessarily mean an accepted answer was available.

progress

  1. loadingLoading source
  2. processingProcessing request
  3. completeRequest complete0.9 s
then check valid
true

Recorded 2026-09-21 · cite a paper

03

Structured output and its limits

Accepted structured output meets the documented shape and quality checks. Declared schema fields must be acknowledged in the returned objects. A supported null value can represent unavailable information. Natural-language-only field coverage and the completeness of the source remain unmeasured.

result

valid
true
schemaValid
true
requestedFields
6 of 6
name
"requests"
version
"2.34.2"
released
"May 14, 2026"
license
"Apache Software License (Apache-2.0)"
requires_python
">=3.10"
summary
"Python HTTP for Humans."

Recorded 2026-09-24 · check a release

04

Evidence you can inspect

Checkable values include source excerpts where available. Text presence does not establish that a value belongs to the requested entity or that the source is factually correct. A signed receipt establishes Contrie's issuance and response integrity, not semantic truth.

evidence

  • offers.price51.77found in the page

    …Product Type | Books | | Price (excl. tax) | £51.77 | | Price (incl. tax) | £51.77 | | Tax | £0.…

  • offers.priceCurrencyGBPmatched by its symbol (£)

    A Light in the Attic # A Light in the Attic £51.77 In stock (22 available) --- Warning! This is…

groundingCoverage
3 of 3 checkable

Recorded 2026-09-24 · track a price

05

Freshness and reuse

Page reuse is opt-in and account-private. When you allow reuse, inspect the original source fetch time. A recent fetch does not guarantee that the publisher's information is current. Recorded examples are labeled and do not fetch the current page.

sourceRecorded example

source.fetchedAt

source.mode
fetched
cached
false

Recorded 2026-09-23 · does not fetch the current page

06

Credits and availability

The final response reports customer credits charged. Rejected structured extractions charge zero answer credits. Markdown is ungraded and costs one credit when accepted. Live requests require authentication, remaining allowance and available capacity.

credits

Credits charged by four recorded runs, and two published charges
Read a tablerecorded, accepted1
Cite a paperrecorded, accepted1
Check a releaserecorded, accepted1
Track a pricerecorded, accepted1
Rejected structured extractionpublished charge0
Markdown, acceptedpublished charge1

Recorded 2026-09-23 · published credit table

See it run

Paste a URL. Read the receipts.

You have seen a recorded example run. A key lets you ask your own page, and see its result, evidence and credits.