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.
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)
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.
Need a data license?
For institutional use, redistribution rights, or a structured data agreement, see Data Licenses.
Data licensing