bloom.ai
Real-time intelligence
for your applications
Integrate geopolitical events, verified sources, and threat data directly into your products with a simple REST API.
$ curl https://bloom.ai/api/public/events \
-H "Authorization: Bearer bloom_sk_..." \
-G -d "category=conflict" -d "severity_min=7"
// Response
{
"events": [
{
"id": "evt_8f3a...",
"title": "Naval standoff in South China Sea",
"severity": 8,
"sourceCount": 12,
"sources": [...]
}
],
"pagination": { "total": 142 }
}
Why developers choose
the Bloom API
RESTful & predictable
Standard JSON responses, intuitive query params, and consistent pagination across all endpoints.
Source-verified data
Every event includes traceable sources — Reuters, AP, UN reports and more — so you can trust the data.
Real-time updates
Events are ingested and classified in under 60 seconds, so your applications always have the latest intelligence.
Built for scale
Rate limiting, pagination, and efficient filtering designed for production workloads from day one.
Developer experience
Ship faster. Integrate smarter.
Stop building geopolitical data pipelines from scratch. One API key gives you access to thousands of verified events, filterable by category, region, severity, and time range.
Endpoints
Clean, predictable endpoints
The Bloom API exposes RESTful endpoints that return structured JSON with consistent schemas. Filter events by category, region, severity, and time — or fetch individual events with full source details.
- JSON responses with consistent schemas
- Flexible query parameters for precise filtering
- Pagination with total counts for easy traversal
/api/public/eventsList events with filters for category, region, severity, and time range. Paginated and sorted by recency.
/api/public/events/:idRetrieve a single event by ID with full source details including URLs, source types, and publication dates.
Production
bloom_sk_prod_8f3a...
Staging
bloom_sk_stg_c91b...
Legacy v1
bloom_sk_v1_02ef...
Security
Secure by default
Every request is authenticated with a Bearer token. API keys are hashed at rest, scoped to your organization, and revocable instantly from the admin dashboard.
- Bearer token authentication on every request
- Keys hashed with SHA-256 — never stored in plain text
- Instant revocation from the admin panel
Rate limiting
Built for production
Every response includes rate limit headers so you can build resilient integrations. The sliding window resets every 60 seconds with generous limits for production workloads.
Max requests per window
Requests remaining
Window reset (Unix timestamp)
100
req/min
60s
Window
<50ms
Latency
What you can build
From internal dashboards to customer-facing products, the Bloom API powers intelligence across every use case.
Risk monitoring platforms
Feed real-time geopolitical events into your risk dashboards. Filter by region and severity to surface only what matters to your clients.
Data pipelines & ETL
Ingest verified events into your data warehouse for trend analysis, reporting, and machine learning models.
Internal tools & bots
Power Slack bots, alerting systems, and internal dashboards with structured intelligence data.
Research & analysis
Pull structured event data for academic research, OSINT investigations, and geopolitical analysis.
Powerful filtering
Query exactly the intelligence you need. Combine multiple filters to narrow results by category, region, severity threshold, and time window.
Category & region
Filter events by type — conflict, diplomacy, economic, or humanitarian — and by geographic region.
Severity thresholds
Set minimum severity levels (1-10) to surface only high-impact events that warrant attention.
Time windows
Scope queries to the last hour, day, week, or custom range. Perfect for scheduled polling or real-time feeds.
Start building today
Get your API key and integrate real-time geopolitical intelligence into your stack in minutes.