Compassion Benchmark
Data access

API access

Compassion Benchmark score data is available as public JSON and, coming soon, as a key-gated Pro API with richer fields, change history, and evidence references.

Available tiers

Start with the free public JSON. Upgrade to Pro when you need richer fields or change history.

FreePublic

Public JSON

Static JSON files served from compassionbenchmark.com/data/ — CORS-open, regenerated on each build. No API key required.

  • All 7 index families
  • Rankings, composite scores, and band for each entity
  • Dimension-level scores
  • Regenerated nightly after research pipeline runs
  • No rate limiting (static files, Nginx-served)
ProComing soon

Pro API

Key-gated API with richer fields, change history, evidence references, and higher request limits. Designed for institutional data teams and research workflows.

  • Change history per entity (score deltas + dates)
  • Evidence references from change proposals
  • Band history
  • Structured subdimension data
  • Higher rate limits + priority cache

Public JSON — example usage

No SDK. No authentication. Just static JSON over HTTPS.

All entities in an index

GET /data/fortune-500.json

{
  "meta": { "entityCount": 447, ... },
  "rankings": [
    {
      "rank": 1,
      "name": "...",
      "composite": 72.4,
      "band": "Established",
      "scores": { "WE": 4.2, "GC": 3.9, ... }
    }
  ]
}

Available index files

  • GET/data/fortune-500.json
  • GET/data/countries.json
  • GET/data/us-states.json
  • GET/data/ai-labs.json
  • GET/data/robotics-labs.json
  • GET/data/global-cities.json
  • GET/data/us-cities.json

Independence applies to API access too

Pro API access does not grant influence over scores, entity inclusion, or research priorities. The API serves published data only — the same data visible on every public index page. The assessment pipeline operates in a separate technical plane with no awareness of API subscribers.

Start with public data

The public JSON covers all 7 indexes and updates nightly. For most analytical use cases it is sufficient. Files at /data/*.json are CORS-open.

Browse published research

Need a data license?

For institutional use, redistribution rights, or a structured data agreement, see Data Licenses.

Data licensing