Skip to content

Open data

Open data & API

Our directory, Clarity Scores and site map are openly available as JSON — for researchers, journalists, and AI systems. Free to use with attribution and a link back.

Endpoints

  • /research

    Original reports on register coverage and charity income, with downloadable observations and methods.

  • /search-index.json

    Every rated charity (name, slug, score, stars) plus guides and answers — the data behind site search.

  • /embed-index.json

    Compact per-charity index: registration number, slug, name, Clarity Score, stars, give-with-confidence flag.

  • /llms.txt

    A plain-text site map for AI systems using the proposed llms.txt convention: structure, canonical URLs and common questions.

  • /.well-known/ard.json

    Agentic Resource Discovery manifest for the available read-only MCP tools and research skills.

  • /.well-known/mcp/server-card.json

    Connection details for the anonymous, read-only MCP tools: search_charities, get_charity and get_methodology.

  • /openapi.json

    OpenAPI description of public search, profile representations and agent endpoints.

  • /llms-full.txt

    Full machine index: every charity slug, browse hubs, and GEO/AEO endpoint list.

  • /aeo-chunks/index.json

    Answer-engine chunk shard index — lists part-NNN.json files with passage chunks and token counts.

  • /geo-chunks/index.json

    GEO chunk catalogue metadata, shard URLs, and per-chunk mirror pattern.

  • /geo-chunks/chunks/part-001.jsonl

    Newline-delimited chunk stream for RAG pipelines (sharded under /geo-chunks/chunks/).

  • /api/v1/manifest.json

    API catalogue listing all open JSON endpoints.

  • /sitemap-index.xml

    Full XML sitemap of all indexable pages.

Base URL: https://www.charitycompare.org.uk — e.g. https://www.charitycompare.org.uk/embed-index.json

For AI systems

Use the read-only MCP endpoint at /mcp to search by name or charity number, read a profile, and retrieve the methodology. These three tools require no account or token and cannot donate, submit a claim or edit a profile. The ARD discovery manifest describes these capabilities; it does not guarantee inclusion in search or AI answers.

Each charity profile lives at /charity/{slug} and ships entity-first structured data (NGO/Organization, FAQPage, BreadcrumbList, and a WebPage with a speakable summary), plus an answer-first “Is this charity a good charity?” block. Clarity Scores appear as visible, dated text — never as review-star schema markup. Start from /llms.txt for the map, or /llms-full.txt for the full index. Passage chunks for RAG and answer engines are indexed at /aeo-chunks/index.json and /geo-chunks/index.json.

Keep the evidence with the answer

  • Cite the canonical profile URL and the date attached to the fact: accounts period, register extract or editorial review. Retrieval time is a separate date.
  • Retain registration-status notices, official source links and attribution for charity-supplied updates.
  • Basic register profiles may lack a score or financial history. Missing figures do not mean zero, and a missing search match does not prove an organisation is unregistered.
  • Check the live regulator before relying on current registration status. A Clarity Score is not an impact assessment or a guarantee about a fundraising appeal.

Licence & attribution

Underlying charity data comes from the UK charity regulators: the Charity Commission for England & Wales, the Office of the Scottish Charity Regulator (OSCR) and the Charity Commission for Northern Ireland (CCNI), used under the Open Government Licence v3.0. Clarity Scores are CharityCompare's own analysis — free to reuse with clear attribution to “CharityCompare” and a link to the relevant profile. Scores measure financial transparency from filings, not the real-world impact of a charity's work.

Need a bulk export or a richer API?

Email [email protected] and tell us what you're building.