Skip to main content
v1.0OPEN API

WORLDPULSE DEVELOPER API

Access real-time global intelligence from 50,000+ sources. Verified signals, reliability scores, geolocation data, and AI-powered briefings — all through a simple REST API. Free for open-source projects.

Interactive API DocsView on GitHub◆GraphQL Playground

API TIERS

FREE

Public

Open access for research, open-source projects, and prototyping.

  • • Public signals, search, feed
  • • RSS / Atom / JSON Feed
  • • Country risk scores
  • • 60 req/min rate limit
AUTH

Authenticated

Free account required. Higher limits and personalized data.

  • • Everything in Public
  • • Daily AI briefings
  • • Following feed
  • • 120 req/min rate limit
$12 / MO
PRO

Pro

Full intelligence suite for analysts, newsrooms, and enterprise.

  • • Everything in Authenticated
  • • Missile & drone intelligence
  • • Maritime/naval tracking
  • • GPS/GNSS jamming zones
  • • STIX 2.1 export & signed bundles
  • • 600 req/min rate limit

QUICK START

1

No signup needed

Public endpoints work immediately. Just make a GET request.

2

Get an API key

Register an account and create a key for authenticated endpoints.

3

Build something

Dashboards, bots, alerts, research tools — the data is yours.

# List latest verified signals (no auth needed)
curl -s "https://api.world-pulse.io/api/v1/public/signals?limit=10&category=conflict" | 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 .

# Authenticated: get your daily briefing
curl -s -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.world-pulse.io/api/v1/briefing/daily" | jq .

WHY WORLDPULSE API

🌍

50K+ Sources

Wire services, OSINT feeds, GDELT, government databases, and community reports — all deduplicated and verified.

🤖

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 — All responses are JSON with { success, data, meta } shape.

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.

Detailed signal data — verification history, source chain, geolocation.

Specialized intelligence feeds — military, maritime, jamming, threat tracking. Requires Pro API key.

RSS, Atom, JSON Feed, and OPML for integrating WorldPulse into any reader.

Threat intelligence export in STIX 2.1 format + Ed25519-signed source packs. Requires Pro API key.

JWT-based authentication for accessing protected endpoints.

AUTHENTICATION & RATE LIMITS

Authentication

Most public endpoints work without auth. For authenticated endpoints, include a JWT token:

Authorization: Bearer <your-token>

Get tokens via POST /api/v1/auth/login or create API keys in your account settings.

Rate Limits

Public endpoints60 req/min
Authenticated200 req/min
Auth endpoints5 req/min
Write endpoints10 req/min

Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) are included in every response.

WEBSOCKET STREAMING

Connect to wss://api.world-pulse.io/ws for real-time signal updates. The connection supports automatic reconnection with exponential backoff (1s to 30s) and ping/pong heartbeat.

Event Types

signal.newA new signal has been verified and published
signal.updatedA signal's reliability score or metadata has changed
alert.breakingA breaking news alert has been triggered

PLANS & PRICING

Start free, upgrade when you need more. No lock-in, cancel anytime.

Free

$0/ month

Full core access. No credit card required.

  • ✓60 API requests / minute
  • ✓7-day signal history
  • ✓Up to 3 alert subscriptions
  • ✓Global live feed & world map
  • ✓Community access
  • ✓RSS / JSON Feed export
Get Started — Free
Most Popular

Pro

$12/ month

Higher limits, webhooks & full intelligence suite.

  • ✓600 API requests / minute
  • ✓90-day signal history
  • ✓Unlimited alert subscriptions
  • ✓5 webhook endpoints
  • ✓Advanced analytics
  • ✓Priority support
  • ✓Early access to beta features

Secure checkout via Stripe. Cancel anytime.

🔒

7-day money-back guarantee

Not satisfied within 7 days? Email support@worldpulse.io for a full refund — no questions asked.

READY TO BUILD?

WorldPulse is open source and free for non-commercial use. Start building with the public API today — no API key required.

Try the API NowGet Your API Key