Developers
Read-only REST API + bulk data. Zero auth. CC BY 4.0.
Two ways to consume
Pick the smaller footprint:
- Bulk dumps — grab everything as JSON/CSV/graph.json from /data/latest/. Regenerated on every publish. Best for research / heavy consumers.
- REST API — query below endpoints. Rate limit: 60 req/IP/min. Best for lookups, embeds, and light integrations.
Endpoints
GET/api/v1/statsCounts + last published_at. GET/api/v1/entities?type=&country=&year_from=&year_to=&limit=50&offset=0Paginated entity list. Filters:type (INCIDENT, STATUTE, …), country, year_from, year_to. Max limit=100.
GET/api/v1/entities/{id_or_slug}Single entity with impact, citations, and its causal neighbours (incoming + outgoing).
GET/api/v1/on-this-dayEvery entity whose start_date matches today's calendar day.
GET/api/v1/newly-added?days=30Most recent additions in the last N days.
GET/api/v1/search?q=X&limit=25Full-text search across name + aliases + summary + country. Same ranker as the site's own search.
Response shape
Every response is JSON, wrapped in a consistent envelope:
{ "ok": true, // … payload … "meta": { "generated_at": "2026-08-04T05:12:00+00:00", "license": "CC BY 4.0", "attribution": "CrisisGraph — crisisgraph.com", "docs": "https://crisisgraph.com/api/v1/" } }
Errors:
{"ok": false, "error": "entity_not_found", "id_or_slug": "…"}
Attribution
License: CC BY 4.0. If you republish or build on this data, attribute “CrisisGraph — crisisgraph.com” with a live link back.
Rate limit
60 requests per IP per minute. Over the cap returns 429 Too Many Requests with a Retry-After: 60 header. If you need higher throughput, use the bulk dumps at /data/latest/ instead — they'll fit anything the REST API would.
Example: fetch a single entity
curl -s https://crisisgraph.com/api/v1/entities/incident-hurricane-katrina \ | jq '.entity.impact, .causal.outgoing[].entity.name'
Example: search + paginate
curl -s 'https://crisisgraph.com/api/v1/search?q=nuclear&limit=100' \ | jq '.count, .entities[].name'
Get in touch
Building something with CrisisGraph? crisisgraph@zafronix.com.