Developers

Read-only REST API + bulk data. Zero auth. CC BY 4.0.

Two ways to consume

Pick the smaller footprint:

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.