Get News Events
Live geopolitics & conflict news events — updated every 30 minutes from 22 RSS feeds.
Cost: 3 credits per request
Categories: armed_conflict, explosions, civilian_violence, protests, riots, terrorism, political_violence, crisis, strategic, diplomacy, sanctions, elections, nuclear, cyber, maritime
Filters (all optional, combinable):
- country, city, cities (comma-separated)
- event_category, source, date_from, date_to
Unique list modes (mutually exclusive):
- get_unique_cities, get_unique_countries, get_unique_categories, get_unique_sources
Pagination: page + limit (default 30, max 100)
Request
- Base URL: https://api.fincept.in (the document declares no server; this is the origin it was published from)
- URL: https://api.fincept.in/research/news-events
- Auth: API key in header X-API-Key
Query parameters
Filter by country (e.g., 'Iran', 'Ukraine')
Filter by single city (e.g., 'Baghdad')
Comma-separated cities (e.g., 'Baghdad,Tehran,Kyiv')
Filter by category: armed_conflict, explosions, civilian_violence, protests, riots, terrorism, political_violence, crisis, strategic, diplomacy, sanctions, elections, nuclear, cyber, maritime
Filter by RSS source name (e.g., 'BBC World', 'Al Jazeera')
Start date filter ISO format (e.g., '2026-04-01')
End date filter ISO format (e.g., '2026-04-20')
Return list of unique cities instead of events
Return list of unique countries instead of events
Return list of unique event categories instead of events
Return list of unique RSS sources instead of events
Page number (starts from 1)
Events per page (max 100)
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.