Developers & API

A free, versioned REST API over our verified incident dataset. Data is licensed CC BY 4.0 — please cite the Bangladesh Violence Tracker.

Getting a key

Create a free account, then generate a key from your account. Send it as a Bearer token:

curl -H "Authorization: Bearer pvt_your_key" \
  "https://violencetracker.org/api/v1/events?district=Dhaka&limit=20"

Default limit is 1,000 requests/day per key.

Endpoints

GET/api/v1/events

List verified violence incidents. Filters: district, category, from, to, page, limit (max 100).

GET/api/v1/events/{id}

Full record for one incident.

GET/api/v1/stats

Totals, casualties, and counts by category.

Example response

{
  "data": [
    {
      "id": "…",
      "title": "…",
      "district": "Dhaka",
      "dateOfIncident": "2026-09-20T00:00:00.000Z",
      "category": "Political Violence",
      "killed": 0, "injured": 3,
      "confidence": 0.86, "reviewStatus": "ai_classified",
      "perpetratorParties": ["BNP"], "victimParties": ["Awami League"],
      "source": "Prothom Alo", "url": "https://…"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 3200, "totalPages": 64 },
  "license": "CC BY 4.0 — cite Bangladesh Violence Tracker"
}

Embeddable widget

Drop a live counter on any site (no key needed):

<iframe src="https://violencetracker.org/embed/counter"
  width="100%" height="150" frameborder="0"
  title="Bangladesh Violence Tracker"></iframe>

Citation

Bangladesh Violence Tracker (2026). Political violence incident dataset. Retrieved from https://violencetracker.org. Licensed under CC BY 4.0.