For developers

Global news API for geopolitical intelligence

Around 70,000 articles per 24 hours, from more than 30,000 active outlets in 222 countries, in every major language. Deduplicated, classified, country-attributed — and queryable as JSON over HTTPS. No monthly subscription: you pay per call in credits.

curl "https://terra-orb.com/api/public/v1/articles?country=US&topic=defense&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

import requests

r = requests.get(
    "https://terra-orb.com/api/public/v1/events",
    params={"country": "UA", "limit": 20},
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(r.json())

const res = await fetch(
  "https://terra-orb.com/api/public/v1/ask?q=Red Sea shipping risk&mode=rapide",
  { headers: { "x-api-key": process.env.TERRA_ORB_KEY } },
);
const report = await res.json();

Endpoints

• GET/api/public/v1/articles

  Raw multilingual articles, filterable by country, language, topic and date.

• GET/api/public/v1/events

  Deduplicated events: one story, all the outlets that carried it.

• GET/api/public/v1/signals

  Early signals: unusual coverage spikes before they become headlines.

• GET/api/public/v1/barometers

  Per-country and per-topic tension barometers.

• GET/api/public/v1/coverage

  Who covers whom: coverage share across countries and spheres.

• GET/api/public/v1/sources

  Directory of tracked outlets with country, language and reliability.

• GET/api/public/v1/ask

  AI investigation engine: a sourced report answering a free-form question.

Why teams switch from raw news feeds

• 222 countries instead of a few dozen English-first markets.
• One event, not forty copies of the same wire story.
• Four information spheres compared side by side: Western, BRICS, Arab-Muslim, Global South.
• Early signals fired before a story reaches mainstream media.
• Sourced AI investigations of 2,000 to 4,000 words, returned as structured JSON.

FAQ