API Reference
Build with intelligence.
Integrate real-time conflict data, AI-powered analysis, and predictive intelligence into your applications. RESTful API with 28+ documented endpoints.
https://api.conflictradar.co Version: v1Authentication
All API requests require a Bearer token in the Authorization header. Generate API keys from your organization settings (Business plan and above). Keys use the cok_live_ prefix.
curl -X GET https://api.conflictradar.co/api/v1/events \
-H "Authorization: Bearer cok_live_your_api_key_here"TLS 1.3
All connections encrypted
SHA-256 hashed
Keys never stored in plaintext
Key rotation
Zero-downtime credential rotation
Rate Limits
Rate limits are enforced per API key using a token-bucket algorithm. Exceeding the limit returns 429 Too Many Requests with Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.
| Plan | Requests / Hour | Burst Limit | Data Retention |
|---|---|---|---|
| Free | 100 / hour | 10 / min | 7 days |
| Pro | 1,000 / hour | 60 / min | 90 days |
| Business | 10,000 / hour | 300 / min | 1 year |
| Enterprise | Unlimited | Custom | Custom |
Authentication
Manage API keys and authenticate requests. Business plan and above.
Ready to integrate?
Get started with a free account and explore the API. Upgrade to Business for programmatic API key access and higher rate limits.