Confirmed public API

Apply Citation Integrity™ outputs to an external workflow.

The currently confirmed public contract provides one authenticated Score endpoint for a URL or claim. Separate public Audit, Watch and Monitor endpoints are not available today.

By CiteAbility™ · Last updated

Key takeaways.

  • One authenticated endpoint is confirmed today: POST /api/public/v1/score for a URL or a claim.
  • Requests are authenticated with an account-scoped API key sent as a Bearer token, and each key is rate-limited.
  • There is no subscription or setup fee; calls are billed in CiteAbility™ Credits by the number of citations checked.
  • Responses return the eight public dimension-level outputs; signals, weights and thresholds stay confidential.
  • CiteAbility™ cannot guarantee citation, recommendation, ranking or inclusion by any external AI system.

Endpoint

POST /api/public/v1/score

Send a URL for a page check or a claim for a claim score. Include an account-scoped API key as a Bearer token. The API is available to any account and each key is rate-limited. There is no separate subscription or setup fee; usage is billed through CiteAbility™ Credits at a flat rate for the number of citations a call checks.

URL request
curl -X POST https://citeability.ai/api/public/v1/score \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/article","title":"Example article"}'
Claim request
curl -X POST https://citeability.ai/api/public/v1/score \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"claim":"A factual statement to assess","source_text":"Relevant supporting text"}'

Cost

What a call costs in Credits

Calls are charged at a flat rate for the number of citations checked. A claim request checks one citation. A URL request checks every citation found on the page. There is no separate subscription or setup fee.

BandCitations checkedCredits
Small1–58 Credits a call
Medium6–2033 Credits a call
Large21–5085 Credits a call
Bulk51+2.5 Credits a citation

Credits are the single currency across CiteAbility™, so the same balance covers API calls and in-app analysis. A call that cannot be completed is refunded. If a balance is too low, the API answers with a payment-required response and the required Credit amount instead of running the check.

Request contract

Documented public fields

Accepted inputs

  • url — optional URL; required when no claim is supplied
  • title — optional page title
  • locator — optional source locator
  • claim — optional claim; required when no URL is supplied
  • source_text — optional supporting text
  • product — optional permitted product context

Response types

URL requests return a page_check with a Citation Integrity™ score, decision, confidence, claims checked, integrity flags and framework version. Claim requests return a claim_score with an identifier, score, decision, confidence, summary and approved dimension-level outputs.

Public framework

Eight dimension-level outputs

Source Authority; Entity Authority; Organizational Probity; Evidence & Citations; First-Hand Experience; Content Quality; Technical Accessibility; and Integrity Analysis. Underlying signals, weights, thresholds, gates, calculations and verification mappings remain confidential.

Boundaries

Outputs support decisions; they do not control AI providers

CiteAbility™ does not claim adoption by unaffiliated AI providers. Each provider retains control over whether and how it uses any output. API responses do not guarantee citation, retrieval, ranking, recommendation or mention.

FAQ

Frequently asked questions

The questions organisations ask us most often.

What does an API call cost?
Calls are charged in CiteAbility™ Credits by banding, based on how many citations were checked. A claim request checks one citation; a URL request checks every citation found on the page.
What happens if my Credit balance is too low?
The API returns a payment-required response with the Credit amount needed, and does not run the check. Calls that cannot be completed are refunded.
Are Audit, Monitor and Watch available over the API?
Not today. The only confirmed public endpoint is the Score endpoint. Additional endpoints will be documented here when they are confirmed.
How do I get an API key?
Create a free CiteAbility™ account, open the API page in your dashboard and press Create key. Calls use your Credits.