WORLDPULSE DEVELOPER API
World stories with how many independent outlets reported each, from 1,000+ outlets a day: verified stories, reliability scores, places and AI briefings, through a simple REST API and an MCP server. The code is open source under the MIT license.
API ACCESS
Public
No key, no sign-up.
- • Stories with their outlet counts, signals, search, feeds
- • RSS / Atom / JSON Feed, OPML
- • The MCP server for AI assistants
- • Up to 200 requests a minute (some endpoints fewer)
Signed in
The same limits, plus what needs an account.
- • Everything in Public
- • Daily AI briefings and the following feed
- • Up to 10 webhooks
- • API keys for the STIX export
Pro
For using WorldPulse at work.
- • Everything in Signed in
- • A Pro key with its own budget: 600 requests a minute, 50,000 a day
- • Commercial use, with a link back
- • Priority support
QUICK START
No signup needed
Public endpoints work immediately. Just make a GET request.
Get an API key
Register an account, then create a key on the API keys page. Keys open the STIX export; endpoints marked SIGN-IN take your sign-in token instead.
Create an API key →Build something
Dashboards, bots, alerts, research tools — the data is yours.
# List latest verified signals (no sign-in needed)
curl -s "https://api.world-pulse.io/api/v1/public/signals?limit=10&category=conflict" | jq .
# The categories the category parameter takes
curl -s "https://api.world-pulse.io/api/v1/public/categories" | jq .
# Search for a topic
curl -s "https://api.world-pulse.io/api/v1/search?q=earthquake&type=signals" | jq .
# Get map hotspots
curl -s "https://api.world-pulse.io/api/v1/signals/map/hotspots" | jq .
# Daily briefing: the top 20 signals of the last 24 hours, by category
curl -s "https://api.world-pulse.io/api/v1/briefing/daily" | jq '.data.sections'WHY WORLDPULSE API
1,000+ Outlets a Day
Wire services, OSINT feeds, GDELT, government databases, and community reports — deduplicated, with every report checked against the others.
AI Verification
Multi-stage reliability scoring with transparent audit trails. Every score is explainable.
Geolocation
PostGIS-powered spatial queries. Bounding box filters, hotspot detection, and convergence analysis.
Real-Time
WebSocket streaming for live signal updates. New events hit your app within seconds.
Open Source
MIT licensed. Self-host the entire stack or use our hosted API. Your data, your rules.
STIX 2.1 Export
Threat intelligence in industry-standard format. Integrates with any TIP or SIEM.
API REFERENCE
Base URL: https://api.world-pulse.io — Responses are JSON, most of them { success, data } plus a list's paging fields (on /public/signals: total, total_exact, limit and offset).
Access verified world events — no authentication required.
Real-time global feed with trending topics and AI-curated content.
Full-text search with Meilisearch — typo-tolerant, faceted, and fast.
Each event once, with how many outlets (websites) reported it and which ones — no authentication required.
Detailed signal data — verification history, source chain, geolocation.
Specialized intelligence feeds — military, maritime, jamming, threat tracking. Threats and jamming need a free account's sign-in token; the rest need nothing.
RSS, Atom, JSON Feed, and OPML for integrating WorldPulse into any reader.
Threat intelligence export in STIX 2.1 format (needs an API key of any tier) + Ed25519-signed bundles of the newest verified signals (need a sign-in token).
Sign-in tokens (JWT) for the endpoints marked SIGN-IN, and API keys for the STIX export.
AUTHENTICATION & RATE LIMITS
Authentication
Most endpoints work without signing in. Endpoints marked SIGN-IN take the accessToken that POST /api/v1/auth/login answers inside data (it lasts 24 hours):
Authorization: Bearer <accessToken>Endpoints marked API KEY (the STIX export) take a key from the API keys page, sent as X-Api-Key: <key>. A key won't work in place of a sign-in token, or the other way round.
Rate Limits
A free key counts like no key, and a sign-in doesn't raise the limits. Send a key as X-Api-Key.
Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) are included in every response.
Errors
Every error answers the same JSON, with the HTTP status:
{ "success": false, "code": "NOT_FOUND", "error": "Signal not found", "statusCode": 404 }code is one word for the kind of error: BAD_REQUEST, VALIDATION_ERROR, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT, RATE_LIMITED, INTERNAL_ERROR, UPSTREAM_ERROR, SERVICE_UNAVAILABLE, or an endpoint's own (such as SOURCE_EXISTS). error says what went wrong, in words. Some errors carry more fields (a list of valid values, say). The MCP server answers JSON-RPC errors instead.
WEBSOCKET STREAMING
Connect to wss://api.world-pulse.io/ws for real-time signal updates. Messages are JSON: { event, data, timestamp, id }. The server sends a ping event every 30 seconds: answer each with {"type":"pong"}, or it closes the connection after 60 seconds without one. It doesn't reconnect for you: when the connection closes, open a new one after a short wait. To add channels, send {"type":"subscribe","payload":{"channels":["all"]}}.
Event Types
signal.newA new report has been saved (it may not be verified yet)alert.breakingA breaking news alert has been triggeredtrending.updateThe trending topics have been updatedpost.newA new feed post (subscribe to "all" to get every one)pingThe server's heartbeat: answer it with a pongAI ASSISTANTS (MCP)
AI assistants can ask WorldPulse directly. Its MCP server (MCP is the protocol assistants such as Claude use to call outside tools) is at https://api.world-pulse.io/mcp: no sign-up, no key, read-only. Every answer gives the outlet count, whether the story is verified and its world-pulse.io link, as text and as structured data. It allows 60 requests a minute per address (600 for the addresses Anthropic and OpenAI publish for Claude's and ChatGPT's tool calls, which many people share), and each tool call counts as a call to the route it asks.
Tools
top_storiesThe stories the most outlets carry in the last 1 to 72 hours, optionally one country'sstoryOne story with every outlet and its reports, from a story or report idsearch_reportsReports about a subject, found by meaningweekWorldPulse Week: a week's top stories and its busiest countriescheck_linkAn article's address: how many outlets reported its story, and whichunder_reportedThe crises with the fewest outlets for the people displaced (UNHCR), the last 7 days or a finished weekstory_numbersA story's numbers (the dead, the injured…), each with how many outlets give itoutletWhat a news website is: its country, its kind, state media or notnearThe reports pinned on the map near a placecountryA country right now: the outlets based there, its stories, under-reported or notdaily_briefThe Daily Briefing: the main developments and what to watchentityA person, organisation or place in the news: its stories, who it is in the news withtrendHow coverage of a country or an entity changed, day by daycheck_claimWhat the newsrooms report about a claim, with their counts and numbers (it rules nothing true or false)breakingThe urgent reports of the last few hours, each with how many outlets carry its storytrendingWho and what is in the news most right now, against the day beforehotspotsWhere serious reports of several kinds meet on the mapstory_by_countryOne story country by country: whose newsrooms carry it (state media marked) and how they headline itshippingShips, ports, straits and navies, near any of 12 chokepointshazardsEarthquakes, volcanoes, tsunamis and large wildfires (USGS, NOAA, NASA)latestThe newest verified reports, of one subject or one countryhow_verifiedHow a story was checked: its outlets, then each comparison of what they reportstory_timelineWho reported a story first, the next outlets in order, and how long verification tookconflictsWhere conflict and military news is reported in the last 72 hoursinternet_outagesInternet outages by country, from IODA (Georgia Tech)connectionsWho and what a person, organisation or place is named with, or the stories naming two of themprotestsProtests, strikes and unrest on the map in the last 48 hours, place by placeoutbreaksDisease outbreaks on the map in the last 72 hours, place by placedisplacementRefugees and people displaced on the map in the last 72 hours, place by placewho_coversThe newsrooms WorldPulse reads in a country: their kind, language, state media or notdayOne day's top stories, from the last 30 days, ranked by independent outletsunconfirmedThe newest serious reports no second outlet has confirmed yet: leads, not factsnewly_verifiedReports that just turned verified, with the second outlets that confirmed themlocal_pressStories the world reports while their own country's press barely appears among the outletssite_checkWhether a website is a known AI content farm, and the reliability score WorldPulse gives itquiet_placesThe places whose news most rarely finds a second outlet, with the reports still waiting for onestory_languagesThe languages a story is reported in, with its outlets in eachverified_in_languagesThe newest reports in other languages than English that turned verifiedlanguages_todayThe languages the news came in: reports, countries and verified share for eachmissed_in_englishStories verified in other languages that WorldPulse found no English report ofmilitary_aircraftMilitary aircraft in the air now (adsb.lol), and the ones near a placeemergency_flightsAircraft squawking an emergency, radio failure or hijack code nowlive_camerasPublic traffic and weather cameras near a place, with their latest picturebusiest_countriesThe countries with the most news in the last 24 hoursnews_volumeHow much news WorldPulse is reading: reports an hour and a day, outlets, countriessimilar_reportsThe reports closest in meaning to one reportreader_flagsWhat readers flagged on a report, and whyoutlet_mixWhat kinds of newsroom carry a story, state media among themcountry_compareTwo countries side by side: reports, verified share, languages, newsroomsspace_weatherNOAA's space weather alerts and the last day's storm levelschokepoints_newsThe shipping chokepoints named in the news, in seven languagesexploited_vulnerabilitiesCISA's newest Known Exploited Vulnerabilities, ransomware use markedtravel_adviceA country's US State Department level and its US and UK travel noticesfirst_reportersThe outlets that most often report a story firstverification_speedHow fast stories find a second outlet: the median, the fastest, the slowesttopics_todayThe topics of the news now, against the hours beforeoutlet_reportsOne outlet's newest reports, by its websiteregion_top_storiesA region's top stories: Africa, the Americas, Asia, Europe, the Middle East, Oceaniarising_storiesNew stories spreading fast: begun in the last hours, many outlets alreadythin_coverageThe places WorldPulse reads few newsrooms in, by regionsanctions_actionsNew US Treasury (OFAC) and EU sanctions actionsus_weather_alertsUS National Weather Service severe weather warningscarrier_groupsWhere the US Navy's aircraft carriers were last reportedcyber_attacksCyber attacks in the news, by country, in seven languageselections_watchWhere elections are in the news, by countrydisaster_newsDisasters in the news, by countrystate_media_storiesHow much of the top stories state media carrycountry_topicsWhat a country's news is about, topic by topicbusiest_outletsThe outlets WorldPulse reads the most reports fromlocal_only_storiesA country's stories only its own press is reportingnumbers_differTop stories whose outlets give different numbers for the dead, injured or missinglong_running_storiesThe longest-running of the top storiesnews_by_hourThe news hour by hour: reports, verified, seriousserious_placesThe countries with the most serious reports nowstate_media_outletsThe state-run outlets WorldPulse reads, by countryoutlet_languagesThe languages of the newsrooms WorldPulse readshow_worldpulse_countsHow WorldPulse counts outlets and verifies stories, in quotable linesworldpulse_statusWhether WorldPulse is up and reading the newsstory_compareTwo stories side by side: outlets, countries, languages, verificationreport_entitiesThe people, organisations and places a report namestopic_top_storiesOne topic's top stories (sports, health, elections…), of a country or region toowhats_new_todayThe top stories that were not among yesterday'srising_countriesThe countries whose news rose or fell the mostentity_compareTwo people, organisations or places side by sideoutlet_compareTwo outlets side by side: reports, verified share, topics, placesoutlet_profileWhat an outlet reports about: its topics and placescoverage_statsHow much of the world WorldPulse reads, region by regionworld_todayThe world in the last 24 hours, in one answerregion_snapshotA region in the last 24 hours, in one answerfind_outletFind a news outlet by namemost_global_storiesThe stories with outlets from the most countriescountry_rankWhere a country stands in the news, with its neighbourscompare_regionsTwo regions side by sidetopic_countriesWhere one topic's news is reported fromwho_reports_onThe outlets reporting the most on a country, its own press against the restcountry_languagesThe languages a country's news comes innews_by_dayThe news day by day: reports, verified, serioustopic_trendOne topic day by day, the last week against the one beforeregion_topicsWhat a region's news is abouttool_guideWhich tool answers which questionConnect
Step by step for Claude, ChatGPT, Gemini and other apps: Use WorldPulse in Claude, ChatGPT or Gemini.
Claude: Customize, Connectors, “+ Add”, “Add custom connector”; paste the address above and choose no sign-in. Then turn WorldPulse on in a chat (“+”, Connectors). Free accounts can add one custom connector.
Claude Code: claude mcp add --transport http worldpulse https://api.world-pulse.io/mcp
Cursor, in .cursor/mcp.json: {"mcpServers":{"worldpulse":{"url":"https://api.world-pulse.io/mcp"}}}
Fewer tools
For an app that takes 40 tools at most, connect one of these addresses instead: the same server, with one set of its tools.
https://api.world-pulse.io/mcp/essentialsThe essentials: 28 of the most used toolshttps://api.world-pulse.io/mcp/newsThe news now, one story and checking: 39 toolshttps://api.world-pulse.io/mcp/placesCountries, regions and topics: 38 toolshttps://api.world-pulse.io/mcp/outletsOutlets, people and organisations: 19 toolshttps://api.world-pulse.io/mcp/liveLive layers (aircraft, ships, hazards) and government feeds: 16 toolsPLANS
Everything here is free. Pro is for using WorldPulse at work.
Free
$0
- ✓The public API, feeds and MCP server, no key
- ✓Up to 200 requests a minute
- ✓Up to 10 webhooks (free account)
- ✓Alerts on what you follow
- ✓RSS / JSON Feed export
Pro
$12 a month
- ✓Everything in Free
- ✓A Pro API key with its own budget: 600 requests a minute, 50,000 a day
- ✓Commercial use of the API and data, with a link back
- ✓Priority support by email
READY TO BUILD?
WorldPulse's code is open source under the MIT license. Start building with the public API today — no API key required.