Skip to main content
v1.0OPEN API

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

FREE

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)
FREE ACCOUNT

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 · $12/MO

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
See Pro →
Using the data. Personal, research, education and non-profit use of the hosted API is free, with a link back to world-pulse.io. Commercial use, in your own work and products, comes with Pro, with a link back. Reselling or redistributing the data needs a data license: email support@world-pulse.io. The code is open source under the MIT license. What we keep about the people and apps that use it: the privacy policy.

QUICK START

1

No signup needed

Public endpoints work immediately. Just make a GET request.

2

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 →
3

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

The whole API, per signed-in user or per address200 req/min
Most endpoints, each (listed with it above)30–60 req/min
Sign-in endpoints5 req/min
A Pro key (Pro), its own budget: the whole API, and each read endpoint up to 10× its limit600 req/min
A Pro key, a day (resets at midnight UTC)50,000 req

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 triggered
trending.updateThe trending topics have been updated
post.newA new feed post (subscribe to "all" to get every one)
pingThe server's heartbeat: answer it with a pong

AI 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's
storyOne story with every outlet and its reports, from a story or report id
search_reportsReports about a subject, found by meaning
weekWorldPulse Week: a week's top stories and its busiest countries
check_linkAn article's address: how many outlets reported its story, and which
under_reportedThe crises with the fewest outlets for the people displaced (UNHCR), the last 7 days or a finished week
story_numbersA story's numbers (the dead, the injured…), each with how many outlets give it
outletWhat a news website is: its country, its kind, state media or not
nearThe reports pinned on the map near a place
countryA country right now: the outlets based there, its stories, under-reported or not
daily_briefThe Daily Briefing: the main developments and what to watch
entityA person, organisation or place in the news: its stories, who it is in the news with
trendHow coverage of a country or an entity changed, day by day
check_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 story
trendingWho and what is in the news most right now, against the day before
hotspotsWhere serious reports of several kinds meet on the map
story_by_countryOne story country by country: whose newsrooms carry it (state media marked) and how they headline it
shippingShips, ports, straits and navies, near any of 12 chokepoints
hazardsEarthquakes, volcanoes, tsunamis and large wildfires (USGS, NOAA, NASA)
latestThe newest verified reports, of one subject or one country
how_verifiedHow a story was checked: its outlets, then each comparison of what they report
story_timelineWho reported a story first, the next outlets in order, and how long verification took
conflictsWhere conflict and military news is reported in the last 72 hours
internet_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 them
protestsProtests, strikes and unrest on the map in the last 48 hours, place by place
outbreaksDisease outbreaks on the map in the last 72 hours, place by place
displacementRefugees and people displaced on the map in the last 72 hours, place by place
who_coversThe newsrooms WorldPulse reads in a country: their kind, language, state media or not
dayOne day's top stories, from the last 30 days, ranked by independent outlets
unconfirmedThe newest serious reports no second outlet has confirmed yet: leads, not facts
newly_verifiedReports that just turned verified, with the second outlets that confirmed them
local_pressStories the world reports while their own country's press barely appears among the outlets
site_checkWhether a website is a known AI content farm, and the reliability score WorldPulse gives it
quiet_placesThe places whose news most rarely finds a second outlet, with the reports still waiting for one
story_languagesThe languages a story is reported in, with its outlets in each
verified_in_languagesThe newest reports in other languages than English that turned verified
languages_todayThe languages the news came in: reports, countries and verified share for each
missed_in_englishStories verified in other languages that WorldPulse found no English report of
military_aircraftMilitary aircraft in the air now (adsb.lol), and the ones near a place
emergency_flightsAircraft squawking an emergency, radio failure or hijack code now
live_camerasPublic traffic and weather cameras near a place, with their latest picture
busiest_countriesThe countries with the most news in the last 24 hours
news_volumeHow much news WorldPulse is reading: reports an hour and a day, outlets, countries
similar_reportsThe reports closest in meaning to one report
reader_flagsWhat readers flagged on a report, and why
outlet_mixWhat kinds of newsroom carry a story, state media among them
country_compareTwo countries side by side: reports, verified share, languages, newsrooms
space_weatherNOAA's space weather alerts and the last day's storm levels
chokepoints_newsThe shipping chokepoints named in the news, in seven languages
exploited_vulnerabilitiesCISA's newest Known Exploited Vulnerabilities, ransomware use marked
travel_adviceA country's US State Department level and its US and UK travel notices
first_reportersThe outlets that most often report a story first
verification_speedHow fast stories find a second outlet: the median, the fastest, the slowest
topics_todayThe topics of the news now, against the hours before
outlet_reportsOne outlet's newest reports, by its website
region_top_storiesA region's top stories: Africa, the Americas, Asia, Europe, the Middle East, Oceania
rising_storiesNew stories spreading fast: begun in the last hours, many outlets already
thin_coverageThe places WorldPulse reads few newsrooms in, by region
sanctions_actionsNew US Treasury (OFAC) and EU sanctions actions
us_weather_alertsUS National Weather Service severe weather warnings
carrier_groupsWhere the US Navy's aircraft carriers were last reported
cyber_attacksCyber attacks in the news, by country, in seven languages
elections_watchWhere elections are in the news, by country
disaster_newsDisasters in the news, by country
state_media_storiesHow much of the top stories state media carry
country_topicsWhat a country's news is about, topic by topic
busiest_outletsThe outlets WorldPulse reads the most reports from
local_only_storiesA country's stories only its own press is reporting
numbers_differTop stories whose outlets give different numbers for the dead, injured or missing
long_running_storiesThe longest-running of the top stories
news_by_hourThe news hour by hour: reports, verified, serious
serious_placesThe countries with the most serious reports now
state_media_outletsThe state-run outlets WorldPulse reads, by country
outlet_languagesThe languages of the newsrooms WorldPulse reads
how_worldpulse_countsHow WorldPulse counts outlets and verifies stories, in quotable lines
worldpulse_statusWhether WorldPulse is up and reading the news
story_compareTwo stories side by side: outlets, countries, languages, verification
report_entitiesThe people, organisations and places a report names
topic_top_storiesOne topic's top stories (sports, health, elections…), of a country or region too
whats_new_todayThe top stories that were not among yesterday's
rising_countriesThe countries whose news rose or fell the most
entity_compareTwo people, organisations or places side by side
outlet_compareTwo outlets side by side: reports, verified share, topics, places
outlet_profileWhat an outlet reports about: its topics and places
coverage_statsHow much of the world WorldPulse reads, region by region
world_todayThe world in the last 24 hours, in one answer
region_snapshotA region in the last 24 hours, in one answer
find_outletFind a news outlet by name
most_global_storiesThe stories with outlets from the most countries
country_rankWhere a country stands in the news, with its neighbours
compare_regionsTwo regions side by side
topic_countriesWhere one topic's news is reported from
who_reports_onThe outlets reporting the most on a country, its own press against the rest
country_languagesThe languages a country's news comes in
news_by_dayThe news day by day: reports, verified, serious
topic_trendOne topic day by day, the last week against the one before
region_topicsWhat a region's news is about
tool_guideWhich tool answers which question

Connect

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 tools
https://api.world-pulse.io/mcp/newsThe news now, one story and checking: 39 tools
https://api.world-pulse.io/mcp/placesCountries, regions and topics: 38 tools
https://api.world-pulse.io/mcp/outletsOutlets, people and organisations: 19 tools
https://api.world-pulse.io/mcp/liveLive layers (aircraft, ships, hazards) and government feeds: 16 tools

PLANS

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
Create a free account

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
See Pro

READY TO BUILD?

WorldPulse's code is open source under the MIT license. Start building with the public API today — no API key required.