API développeurs alerts.live — gratuite

Une API publique gratuite pour développeurs, traders et journalistes : manifestations, grèves, routes fermées et incidents de rue en direct, dans le monde entier.

Démarrage rapide

# latest events in Paris, GeoJSON
curl "https://alerts.live/api/v1/events?city=paris&format=geojson"

# dangerous events (danger ≥ 60) in Europe since a date, with your key
curl -H "X-API-Key: alk_…" "https://alerts.live/api/v1/events?continent=EU&min_danger=60&since=2026-10-18T00:00:00Z"

# bounding box (W,S,E,N), shootings only
curl "https://alerts.live/api/v1/events?bbox=-5,41,10,51&type=shooting"

# time series: incidents per bucket in France, last week
curl "https://alerts.live/api/v1/stats?period=week&scope=country&value=FR"

# top 5 cities in the last 3 hours
curl "https://alerts.live/api/v1/top-cities?hours=3&n=5"

# one event (news, photos, videos, timeline)
curl "https://alerts.live/api/v1/events/123"

# RSS / Atom per city or country
https://alerts.live/api/v1/feed/city/paris.rss
https://alerts.live/api/v1/feed/country/FR.atom

# webhook (key required)
curl -X POST -H "X-API-Key: alk_…" -H "content-type: application/json" \
  -d '{"url":"https://example.com/hook","types":["shooting","clashes"],"min_danger":50,"scope":"country","value":"FR"}' https://alerts.live/api/v1/webhooks

Obtenir une clé API gratuite

Accès anonyme : 60 requêtes/min. Avec une clé gratuite : 600 requêtes/min. Les clés sont hachées dans notre base ; nous ne pouvons pas les réafficher.

Points d’accès

`GET /api/v1/events`	bbox, city, country, continent, type, min_danger, min_confidence (0–100; default hides unconfirmed user reports), size, since, limit (≤200), offset, format=json\|geojson
`GET /api/v1/events/{id}`
`GET /api/v1/stats`	period=hour\|day\|week\|month\|year, scope=world\|continent\|country\|city, value, types, bands, minDanger, sizes
`GET /api/v1/top-cities`	hours (1–24), n
`GET /api/v1/feed/city/{slug}.rss\|atom`
`GET /api/v1/feed/country/{CC}.rss\|atom`
`POST /api/v1/keys`	free key
`GET\|POST\|DELETE /api/v1/webhooks`	key required
`GET /api/v1/openapi.json`	OpenAPI 3

Spécification OpenAPI · CORS: Access-Control-Allow-Origin: *

Webhooks

Abonnez-vous avec POST /api/v1/webhooks (clé API requise). Chaque envoi est un POST JSON signé en HMAC-SHA256 : en-tête X-Alerts-Signature: sha256=HMAC(secret, X-Alerts-Timestamp + "." + corps). URL HTTPS uniquement ; désactivé après 10 échecs consécutifs.

python: hmac.new(secret.encode(), (ts + "." + body).encode(), hashlib.sha256).hexdigest()

Conditions d’utilisation

Attribution obligatoire : afficher « Données : alerts.live » avec un lien vers alerts.live.
À titre informatif uniquement. Ce n’est pas une source officielle ; les données peuvent être erronées ou tardives. Ne vous y fiez pas pour des décisions critiques. Suivez les consignes des autorités locales.
Aucune donnée de position de police : ces signalements sont rejetés et ne doivent pas être demandés ni redistribués depuis cette API.
Les scores de danger (1–100) et les tailles de groupe sont des estimations automatiques. Les positions sont approximatives au niveau de la ville sauf mention contraire.
Soyez raisonnable : respectez les limites et mettez les réponses en cache. Nous pouvons suspendre les clés abusives.

Besoin de limites plus élevées, de SLA, d’exports d’historique ou d’une licence commerciale ? Une offre payante existe — contactez-nous: contactez-nous.