Terra-Orb API

All of Terra-Orb's live data — events, articles, early signals, barometers, global coverage — in JSON, read-only, to power Terra-OSINT or any other analysis tool. Every article comes with its full captured text, summary, original URL, publisher and exact dates; /ask returns the excerpt of each source it relied on.

Best practices for precise results

  • · Send short keywords (entities + key terms), e.g. q=Suez Basque wastewater, rather than a full headline. Long queries are reduced automatically to their 5 most distinctive words (stopwords removed); the response shows them in query_terms.
  • · Use /articles for real press coverage (full text, date, source domain). /signals is a global early-warning feed: always pass q to keep only matching signals.
  • · Query /articles, /events and /signals in parallel, then apply your own relevance threshold (e.g. similarity ≥ 0.25 to your reference title) before display.

Access and pricing

The API is part of the paid service: the key is created from a Terra-Orb account and is billed in credits, only on the days it is called.

  • · 30 credits per day of use, with 1,000 requests included.
  • · 10 credits per block of 1,000 requests beyond that.
  • · API pay as you go; reading and investigation subscriptions are separate.
Market offerIts priceVolumeTerra-OrB
TheNewsAPI / MediaStack Standard99 $ / mois10 000 à 30 000 requêtes≈ $72 / mois
MediaStack Professional249 $ / mois50 000 requêtes≈ $184 / mois
NewsAPI Business449 $ / mois250 000 requêtes≈ $332 / mois

At equal volume, Terra-OrB costs about 20% less than these subscriptions, with no monthly commitment: you only pay for the days actually called, and across 222 countries and territories monitored (most covered every day) instead of a selection of English-language outlets.

Interactive playground

Pick an example or edit the request, paste your key and see the live JSON. Your key stays in this browser tab and is never stored. Calls count toward your usage like any other.

GET /api/public/v1
curl -H "Authorization: Bearer $TERRA_ORB_KEY" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5"

Endpoints

Base: /api/public/v1 — all responses are in JSON and include generated_at.

GET/api/public/v1/events— Events

Merged events from the last 24h: exact/approximate dates, emitting and concerned countries, languages, number of outlets and articles, tone, intensity.

Parameters: topic, emitter=FR, about=IR, search, sort=media|recent|date|intensite, limit≤300

GET/api/public/v1/events/{id}— Event detail

Full record: coverage breakdown (ownership, orientation, country, language) and related articles.

Parameters: none

GET/api/public/v1/articles— Raw articles

Articles from the last 24h: title, canonical URL, event date vs. publication date, country, topic, tone, outlet type (digital/radio/TV/print), social network.

Parameters: q (full text), from/to (ISO dates), scope=live|archive|all (archive ≈ 1 year), topic, emitter, about, language=fr, form=digital|radio|tv|print, before=<date ISO> (pagination curseur), limit≤200

GET/api/public/v1/ask— AI answer engine (full key)

Free-form question: Terra-OrB archive then public web, critical reasoning, cited summary [n], 4-domain impact matrix, sources, follow-ups.

Parameters: GET ?q=...&mode=rapide|profond, ou POST JSON {question, mode}

GET/api/public/v1/signals— Early signals

Events detected before wide visibility: status, confidence, acceleration rate, lead time, plus global statistics.

Parameters: q (keywords, all must match), status=detecte|confirme|repris, limit≤300

GET/api/public/v1/barometers— Barometers

Cross-referenced frequency and tone by topic, country and language: volume, outlets, sentiment, intensity, tension, situation level.

Parameters: none

GET/api/public/v1/coverage— Global coverage

Capture status by country: active outlets, recent articles, languages, status (covered / weak / missing / no local outlet).

Parameters: none

GET/api/public/v1/sources— Media directory

Active outlets: name, country, language, type, channel (feed, page, social network), documented ownership and orientation, reliability.

Parameters: country=FR, language=ar, form=tv, kind=media|social, before=<id> (pagination curseur), limit≤500

Example

curl -H "Authorization: Bearer tm_votre_cle" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20"

Error codes: 401 (key missing, unknown or revoked), 402 (credits exhausted), 400 (invalid parameters), 404 (resource not found). Pagination of articles and sources uses a cursor: send back the value next_cursor in the parameter before.