Contrie Verify API

The Verify API from Contrie — 1 operation(s) for verify.

GitHub OpenAPI

Operations 1

POST /api/v1/verify Check extracted data against the page it claims to come from #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/contrie-com:contrie-com-verify-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

contrie-com-verify-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Contrie Com Verify API
  version: 1.0.0
  contact:
    email: hello@contrie.com
  description: 'Operations tagged Verify across 2 of this provider''s published API definitions: contrie-com-openapi.json, contrie-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.contrie.com
security:
- bearerAuth: []
tags:
- name: Verify
paths:
  /api/v1/verify:
    post:
      operationId: verify
      summary: Check extracted data against the page it claims to come from
      description: Check supplied data against source text. This endpoint charges no customer credits. The same data and source bytes produce the same result. Text presence does not establish field attribution or factual truth.
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyRequest'
      responses:
        '200':
          description: Grounding report
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: 'URL mode only: the source could not be fetched or refused the request'
          headers:
            Retry-After:
              schema:
                type: integer
                minimum: 1
                maximum: 86400
              description: 'Present only on SOURCE_REFUSED when the source answered 429, or on FETCH_FAILED when it answered 503, with a usable Retry-After: the source''s wait in whole seconds, an HTTP-date converted to seconds, kept between 1 and 86400. A SOURCE_REFUSED whose message says to retry later means retry later even without it.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: 'RATE_LIMITED (the account''s per-minute limit by plan: Free 10, Builder 30, Pro 100 requests per minute; or about 20 failed authentication attempts a minute from one client, which answers with Retry-After 60), PAGE_LIMIT_REACHED (credits unavailable) or INFERENCE_BUDGET_EXCEEDED (a processing limit). Retry-After is present only when waiting helps.'
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds until the caller may retry
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Verification failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: OAuth token lacks the required Contrie account scope. See WWW-Authenticate for the required scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Verify
    servers:
    - url: https://www.contrie.com
components:
  schemas:
    VerifyResponse:
      type: object
      required:
      - success
      - verdict
      - coverage
      - fields
      - metadata
      properties:
        success:
          type: boolean
        grounding:
          type:
          - number
          - 'null'
          minimum: 0
          maximum: 1
          description: Fraction of checkable values found in the page. Null when nothing was checkable — never 0, which would read as 'every value was invented'.
        verdict:
          type: string
          enum:
          - all-grounded
          - ungrounded-values
          - nothing-checkable
        coverage:
          allOf:
          - $ref: '#/components/schemas/GroundingCoverage'
          description: 'Also carries ''ungrounded'': the checkable values not found in the page.'
        fields:
          type: array
          items:
            $ref: '#/components/schemas/FieldGrounding'
          description: Per-value verdicts, ungrounded first, capped at 50.
        metadata:
          type: object
          properties:
            url:
              type:
              - string
              - 'null'
              description: Final URL after redirects for url; for html, the caller's baseUrl, never fetched (null without one).
            source:
              type: string
              enum:
              - fetched
              - html
              - text
            latencyMs:
              type: integer
              description: Time in milliseconds to resolve the source, including any fetch, and check the values.
            credits:
              type: integer
              enum:
              - 0
              description: This endpoint does not charge customer credits.
    VerifyRequest:
      type: object
      required:
      - data
      description: Exactly one of url, html or text must be given.
      properties:
        data:
          description: 'The extracted data to check: any JSON value.'
        url:
          type: string
          format: uri
          description: Page to fetch and check the data against.
        html:
          type: string
          maxLength: 5000000
          description: 'Source HTML, when the caller already has it. Without baseUrl, relative links stay relative: a relative href cannot ground an absolute URL value, which an extraction of the same page (which knows its URL) could. Keep the whole request body under the platform''s 4.5 MB limit.'
        baseUrl:
          type: string
          format: uri
          description: 'With html only: the page the HTML came from. Resolves relative links the way an extraction of that page would. Never fetched.'
        text:
          type: string
          maxLength: 5000000
          description: Source text, when the caller already has it. Keep the whole request body under the platform's 4.5 MB limit.
        options:
          type: object
          properties:
            timeout:
              type: integer
              minimum: 1000
              maximum: 30000
              default: 15000
    ErrorResponse:
      type: object
      required:
      - success
      - error
      properties:
        success:
          type: boolean
          enum:
          - false
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              enum:
              - INVALID_REQUEST
              - INVALID_URL
              - IDEMPOTENCY_CONFLICT
              - IDEMPOTENCY_EXPIRED
              - IDEMPOTENCY_OUTCOME_UNKNOWN
              - REQUEST_IN_PROGRESS
              - NOT_FOUND
              - UNAUTHORIZED
              - INSUFFICIENT_SCOPE
              - PAYMENT_REQUIRED
              - FETCH_FAILED
              - SOURCE_REFUSED
              - RENDER_REQUIRED
              - RATE_LIMITED
              - PAGE_LIMIT_REACHED
              - SERVICE_UNAVAILABLE
              - MODELS_UNAVAILABLE
              - EXTRACTION_FAILED
              - INFERENCE_BUDGET_EXCEEDED
              - INFERENCE_UNAVAILABLE
              - RESULT_NOT_ACCEPTED
            message:
              type: string
    GroundingCoverage:
      type: object
      required:
      - total
      - checkable
      - grounded
      description: How much of the data a grounding ratio speaks for.
      properties:
        total:
          type: integer
          description: Values that assert something; nulls are not counted. Acceptance requires grounded to be at least half of this.
        checkable:
          type: integer
          description: How many of those carried enough text to search for. Booleans and strings under three characters do not; numbers are checked at any length. They still count in total, as values that were not found.
        grounded:
          type: integer
          description: How many of the checkable values were found in the page.
    FieldGrounding:
      type: object
      required:
      - path
      - value
      - grounded
      properties:
        path:
          type: string
          description: JSONPath-style location of the value inside data, e.g. $.stories[0].title. Keys that are not plain identifiers use bracket notation with JSON-escaped quotes, e.g. $["price (USD)"]; array elements are always numeric, e.g. $.items[0].
        value:
          type: string
          description: The extracted value, rendered as a string.
        grounded:
          type: boolean
          description: 'Whether this value''s text was located in the page text by the presence check: strings case-insensitive, with whitespace runs collapsed and the page''s bold, italic and inline-code markers read as formatting (a value''s own * or ` must be on the page); links as the same URL; numbers by value (31.0 matches 31); an ISO date also as the page writes it in words, inside an ISO timestamp, or as a numeric date in the day/month order the page''s own dates establish; GBP, EUR and INR as their symbol beside an amount (£53.74). It shows presence, not that the text belongs to this field or entity. False means unconfirmed by this check, not disproved: a value the page presents differently can be missed.'
        excerpt:
          type: string
          description: Page text surrounding the match, roughly 45 characters either side, with case preserved and whitespace runs collapsed. Absent when grounded is false.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Contrie API key or resource-bound OAuth access JWT
      description: API key created at https://www.contrie.com/dashboard/keys (human sign-up in a browser; there is no programmatic key issuance), or an OAuth access token from the advertised Contrie sign-in flow. OAuth needs no additional API key. Configure credentials through the client or environment, never in a URL or agent chat.
x-refined-from:
- contrie-com-openapi.json
- contrie-com-openapi.yml