Confidence, built on evidence.

The bulk API

Read every judgement of every business with a public page, oldest first, from your own tools. Today the API comes with Business Pro. Truth Connect, a plan paid by use for AI agents, is where we are going.

Your key

Business Pro members make API keys on their account page, up to 10 at a time. A key lasts 30, 90 or 365 days, as you choose. Send it in the Authorization header on every request. The key is shown once, when it is made.

A request

Ask for the first page with after=0:

GET /api/v1/reports?after=0
Authorization: Bearer <your key>

Each answer holds up to 1,000 reports and a next number. Ask again with after set to that number for the next page. On the last page, next is null. Walk again from 0 to read the current state.

The fields

FieldWhat it is
idThe judgement's number. A page's next is its last id.
domainThe business's website address.
kindWhat the page is about: business, or a platform such as youtube.
slugThe page's handle on that platform; null for a business.
judged_atWhen the evidence was judged.
truth_score0 to 100, or null when no score could be given.
purchase_confidenceThe band: HIGH, MEDIUM, LOW, the page's High, Mixed, Low; or null.
reasonsWhat the evidence shows for the business.
concernsWhat the evidence shows against it.

Each reason and concern has a text and the source it came from.

An answer

The shape of an answer, with made-up values:

{
  "reports": [
    {
      "id": 81234,
      "domain": "example.com",
      "kind": "business",
      "slug": null,
      "judged_at": "2026-11-01T09:30:00+00:00",
      "truth_score": 82,
      "purchase_confidence": "HIGH",
      "reasons": [
        {
          "text": "Company found in official company register",
          "source": "registry"
        }
      ],
      "concerns": []
    }
  ],
  "next": null
}

Limits

60 requests a minute and 5,000 a day for each account, shared by all its keys.

Errors

An error is a JSON answer with a detail field saying why.

StatusWhen
400after is not a whole number.
401No key was sent, the key is not known, it expired or was revoked, or Business Pro has ended for its account.
429Too many requests this minute or today, or too many wrong keys from one address. The Retry-After header says how many seconds to wait.

What it lets you do

Copy reports in bulk, republish them as a data set, resell them, build them into a product under your own name or train an AI model on them, as our terms set out.

Check a business