Access NarrativeRadar's geopolitical intelligence data programmatically. Events, narratives, entities, and divergence signals — all via REST API.
All endpoints are publicly readable. To access authenticated features or increase rate limits, include your API key in the X-API-Key header.
Generate API keys from your Profile page. PRO account required.
All endpoints return JSON. Responses use UTF-8 encoding.
/eventsList events with metadata, quality scores, and source counts.
Parameters: limit (default 100, max 200), offset, q (full-text search), block, phase, quality
/events/{slug}Full event detail: summary, narratives, facts, scenarios, divergence, timeline, sources.
Parameters: slug (event identifier)
/events/{slug}/articlesArticles feeding an event, with source metadata.
Parameters: slug
/sourcesAll active sources with block, tier, country, and domain.
/tagsAll sectors and topics with event counts.
/tags/{kind}/{slug}Events tagged with a specific sector or topic.
Parameters: kind (sector|topic), slug
/entitiesPersons, organizations, countries, and instruments extracted from events.
Parameters: kind, q (search), limit, offset
/entities/{kind}/{slug}Entity detail with associated events.
Parameters: kind (person|organization|country|instrument), slug
List endpoints return JSON arrays. Detail endpoints return JSON objects. Key fields in event responses:
{
"slug": "us-china-trade-tensions-escalate",
"title_en": "US-China Trade Tensions Escalate",
"summary": "...",
"event_phase": "active",
"event_quality": "cross_block",
"distinct_source_count": 12,
"distinct_block_count": 4,
"narrative_divergence_detected": true,
"prominence_score": 0.65,
"radar_score": 0.82,
"sectors": ["trade", "geopolitics"],
"countries": ["us", "cn"],
"last_updated_at": "2026-02-14T12:00:00Z"
}| Tier | Rate Limit | Max Keys |
|---|---|---|
| Unauthenticated | Public access, standard limits | — |
| PRO | Higher limits with API key | 3 |
For simple integrations, use our syndication feeds — no API key required:
/feed.xml/feed.atom