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 inquery_terms. - · Use
/articlesfor real press coverage (full text, date, source domain)./signalsis a global early-warning feed: always passqto keep only matching signals. - · Query
/articles,/eventsand/signalsin 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 offer | Its price | Volume | Terra-OrB |
|---|---|---|---|
| TheNewsAPI / MediaStack Standard | 99 $ / mois | 10 000 à 30 000 requêtes | ≈ $72 / mois |
| MediaStack Professional | 249 $ / mois | 50 000 requêtes | ≈ $184 / mois |
| NewsAPI Business | 449 $ / mois | 250 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.
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.
/api/public/v1/events— EventsMerged 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
/api/public/v1/events/{id}— Event detailFull record: coverage breakdown (ownership, orientation, country, language) and related articles.
Parameters: none
/api/public/v1/articles— Raw articlesArticles 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
/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}
/api/public/v1/signals— Early signalsEvents 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
/api/public/v1/barometers— BarometersCross-referenced frequency and tone by topic, country and language: volume, outlets, sentiment, intensity, tension, situation level.
Parameters: none
/api/public/v1/coverage— Global coverageCapture status by country: active outlets, recent articles, languages, status (covered / weak / missing / no local outlet).
Parameters: none
/api/public/v1/sources— Media directoryActive 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.