Questions from developers
How to read Truth Signal reports from your own code or AI agent.
Questions people ask
How do I read a report as data?
Add .json to a report's address, as in /business/example.com.json. The same report is at /business/example.com/report.md as Markdown, and a short snapshot at /business/example.com/snapshot.json.
Can an AI agent use Truth Signal?
Yes. Connect it to our MCP server: how to connect. Each caller can read 100 reports a day through it.
What are the limits?
A caller address can start 20 checks of new businesses a clock hour. Past a limit the answer is 429, with a Retry-After header saying when to ask again.
How do I read every report in bulk?
With the bulk API: 1,000 reports an answer, up to 5,000 requests a day. It needs an API key from Business Pro. The bulk API.
May I quote or copy reports?
Anyone may read, quote and cite a report, naming Truth Signal with a link to the report. Copying reports in bulk, republishing them as a data set, reselling them and training models need the paid API plan. Our terms.
How fresh is a report?
Every business is checked again once a month. Each judgement carries the time it was made.