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
| Field | What it is |
|---|---|
id | The judgement's number. A page's next is its last id. |
domain | The business's website address. |
kind | What the page is about: business, or a platform such as youtube. |
slug | The page's handle on that platform; null for a business. |
judged_at | When the evidence was judged. |
truth_score | 0 to 100, or null when no score could be given. |
purchase_confidence | The band: HIGH, MEDIUM, LOW, the page's High, Mixed, Low; or null. |
reasons | What the evidence shows for the business. |
concerns | What 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.
| Status | When |
|---|---|
| 400 | after is not a whole number. |
| 401 | No key was sent, the key is not known, it expired or was revoked, or Business Pro has ended for its account. |
| 429 | Too 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.