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. Quotas quotidiens : 1 500 requêtes (anonyme) / 20 000 requêtes (clé gratuite) ; la pagination est plafonnée (offset ≤ 200 en anonyme, ≤ 1 000 avec une clé). 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: *
Remote MCP
A public, read-only Model Context Protocol server is at https://alerts.live/mcp (Streamable HTTP). Tools: search_alerts, get_alert, list_categories, area_summary. It exposes the same public data and cap as the anonymous map (max 500 events, no account or personal data). Rate limit: 60 requests/minute per IP. Each alert includes the original source link; that source keeps its own terms. alerts.live does not claim a Creative Commons (CC BY) or other licence over third-party content — a licence decision is pending. See /skill.md and the terms below.
// Cursor — .cursor/mcp.json or ~/.cursor/mcp.json
{
"mcpServers": {
"alerts-live": { "url": "https://alerts.live/mcp" }
}
}
// Claude: add a custom connector / remote MCP with URL https://alerts.live/mcp
// ChatGPT: add a remote MCP server with the same URL
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 les quotas et mettez les réponses en cache. Nous pouvons suspendre les clés abusives.
- Pas de copie en masse : il est interdit de moissonner, de dupliquer ou de constituer une base ou archive concurrente à partir de cette API ou du site, ni de revendre ou redistribuer les données brutes, sans licence commerciale écrite. Les offres payantes précisent ce que vous pouvez conserver et pour combien de temps.
- Les réponses sont marquées individuellement (filigrane propre à chaque clé dans les liens et les coordonnées) afin de retrouver la clé à l’origine d’une copie divulguée. Utiliser plusieurs clés pour contourner les quotas est interdit et les clés peuvent être désactivées sans préavis.
Besoin de limites plus élevées, de SLA, d’exports d’historique ou d’une licence commerciale ? Une offre payante existe — contactez-nous: Tarifs · contactez-nous.