Read your measurement with your own tools.
Our September 2026 Index contains 2,095 valid answers from 2,100 planned captures across 14 software categories; five failed captures are excluded. These are dated records, not a forecast. Read the dated evidence.
A read only API with an OpenAPI description, signed webhooks that also speak to Slack and Teams, and a connector that lets Claude or ChatGPT read the findings and the receipts under them. A public demo key opens a fictional sample account with no sign up.
Included with every account, free accounts included. There is no API price.
Everything a view in the account shows, the API serves in the same shape, receipts included. The point is that a number we publish can be checked by a machine you control, not only read on a page we drew.
The developers page inside the app, with the keys, the webhook destinations and the connector setup.
get_index_category serves the current Absence Index release. The category availability check is a public GET in the OpenAPI document.
Ask <Vendor>
A read-only connector per Fix Sprint or program client at app.broadcastwell.com/mcp/vendor/<slug>, six tools, answering only from the client's Vendor Facts File. Try the fictional sample, Ask Kalvenor, at app.broadcastwell.com/mcp/vendor/kalvenor. The Vendor Facts File schema is public and CC BY 4.0.
The Proof Page for an account is available at GET /api/v1/proof (the four lines, the period table and de-identified buyer questions, each with source and date) with an account API key; GET /api/v1/kpi is unchanged; the demo key returns the sample. Read only. AI Pipeline Proof.
The three numbers for an account (organic named rate with interval, sponsored presence, AI-referred leads, each with source and date) are available at GET /api/v1/kpi with an account API key; the demo key returns the sample. Read only. See the labelled sample.
The API
| Route | What it returns |
|---|---|
| /me | The account behind the key. |
| /method | The method as data: version, definitions, engines, proof rules, and what the numbers do not prove. |
| /accounts/{account}/runs | Measurements and free checks, including incomplete states. |
| /runs/{run}/summary | One measurement, with counts and rates. |
| /runs/{run}/questions | Every buyer question in the run and its counts. |
| /runs/{run}/receipts | Observed answer text and cited URLs. Filter by question, engine, pass or verdict. |
| /runs/{run}/displacement | Who was named instead, per question and engine. |
| /runs/{run}/sources | Pages the engines cited, with times cited and by which engines. |
| /runs/{run}/fixes | The fixes attached to the measurement. |
| /runs/{run}/compare/{other} | Two runs on shared questions and engines. Refused across method versions. |
| /accounts/{account}/history | Named rate per scheduled run, by account, engine or question type. |
| /accounts/{account}/alerts | Movements where the intervals separate. |
| /accounts/{account}/proof | Controlled lift experiments, with the four counts and the verdict. |
Engine identifiers are chatgpt, claude, perplexity, google_aio and google_ai_mode, and their labels are ChatGPT, Claude, Perplexity, Google AI Overviews and Google AI Mode.
Pre-Call Briefs are available to the account that owns them at GET /api/v1/briefs and GET /api/v1/briefs/<id> with an account API key, receipts included; the demo key returns the sample brief once it is published. Read only.
The Record for an account is available at GET /api/v1/record (statements by class per engine, the Wrong List with causing-page types, the Access Check, Time to AI and the Correction List states, with capture dates; receipts stay in the account) with an account API key; the demo key returns the sample. Read only. The Correction Ledger is public at app.broadcastwell.com/ledger.
The Checklist Audit for an account is available at GET /api/v1/checklist (the criteria table, differentiator coverage with intervals, rival-favoured criteria and the fix list, with capture dates and engines; receipts stay in the account) with an account API key; the demo key returns the sample. Read only. The Buyer's Checklist.
Webhooks
A webhook tells you when a measurement lands or when something moves, so nobody has to sit and refresh a page. Add a destination in the account, choose the events, and verify the signature on arrival.
| Event | When it fires |
|---|---|
| run.completed | A baseline measurement or monthly scheduled run was delivered. |
| alert.fired | A named rate moved between two consecutive comparable scheduled runs and the intervals separate. |
| fix.updated | A fix changed owner, status or review date. |
| proof.updated | A proof result changed. |
| webhook.test | Sent only by the Send test event button. |
The connector for Claude and ChatGPT
Fifteen read only tools, so an assistant can answer questions about your own measurement from the measurement itself rather than from a summary somebody pasted into it. Nothing in the connector writes.
list_runs, get_results, get_question, get_receipts, get_fixes, get_index_category, get_history, get_displacement, get_sources, get_proof, list_alerts, search_answers, compare_runs, get_battlecard, get_method.
Kalvenor Systems is a fictional company. Everything in the sample account is SAMPLE DATA and is there so you can see the views before you buy.
Integrations
| Integration | What it does |
|---|---|
| Smithery | The connector, published and verified on the Smithery marketplace, with all fifteen tools listed. |
| Claude and ChatGPT | Add the connector to an assistant and ask about your own measurements in plain language. |
| The public sample | The same fifteen tools over a fictional data set named Kalvenor, with no sign in. The endpoint is app.broadcastwell.com/mcp/demo/kalvenor. |
| The read only API | OpenAPI 3.1, with account keys you create and revoke yourself. |
Nothing here needs an account to try. The public sample reads a fictional data set named Kalvenor with no sign in at all.
Questions
What does the API cost?
Nothing. Every account, including a free one, can read its own data and the public sample. The API is part of the product rather than an add on, and there is no API price.
Is it read only?
Yes. Version 1 of the API reads. It does not start measurements, change fixes or write anything to your account.
How do we try it without an account?
Use the public demo key, bwp_demo_kalvenor_sample, as a bearer token and read the fictional sample account. It reads the sample and nothing else; any other account answers 404. The limit is 30 requests a minute per address.
What are the limits on a real key?
60 requests a minute and 5,000 a day per key. Keys are made by the account owner, shown once, stored as a one way hash, read only, revocable, and the last used time is shown.
How do we know a webhook came from you?
Every signed delivery carries a Broadcastwell-Signature header holding a timestamp and an HMAC SHA-256 over the timestamp and the raw body. Reject a timestamp more than 300 seconds out. Retries run at 1 minute, 5 minutes, 30 minutes, 2 hours and 12 hours, then stop, and no destination is delivered the same event twice.
What does the connector give an assistant?
Fifteen read only tools over the same data the API serves, so Claude or ChatGPT can read the findings, the receipts under them and the method, and answer questions about your own account. The demo endpoint reads the fictional sample and needs no token.
How are rates and counts shaped?
Every rate is an object carrying its percentage, its low and high bounds, its interval and its base, and the integer count is given beside it. Headline figures are scheduled runs only; adaptive runs are a separate labeled block and the two are never added together.
Terms
API keys, connector tokens and webhooks read your own account data and the public sample. Access is read only and subject to the published limits. The full clause, including when a key may be suspended, is on the terms page, and what is stored for a webhook, a share link or a key is on the privacy page.
One buyer question. One completed repair.
We build one source-backed page or fix for $490. Choose Live or Handoff before payment. We confirm Ready within 60 minutes during business hours. If anything is missing, a member of our team contacts you directly and finishes it with you. The deadline is 48 elapsed hours after recorded Ready.
If we miss the deliverable or deadline, we initiate a full $490 refund within five business days. You keep the work. You may also request a full refund within 30 days of delivery.
Fix one answer, $490One buyer question. One completed repair.
We build one source-backed page or fix for $490. Choose Live or Handoff before payment. We confirm Ready within 60 minutes during business hours. If anything is missing, a member of our team contacts you directly and finishes it with you. The deadline is 48 elapsed hours after recorded Ready.
If we miss the deliverable or deadline, we initiate a full $490 refund within five business days. You keep the work. You may also request a full refund within 30 days of delivery.
Fix one answer, $490