{"openapi":"3.1.0","info":{"title":"Terra-OrB API","version":"1.0.0","summary":"Global multilingual OSINT news intelligence: dispatches, events, early signals, tension barometers and AI investigations.","description":"Terra-Orb monitors public news feeds: 222 countries and territories monitored; most of them covered every day. Source comparison, early signals and source-backed investigations; never predictive. Read-only JSON API. Visitors: 3 articles per page (journal: 5 stories). Free account: 10 articles per page and one 4,000-word AI investigation. Monthly subscriptions: Lecture $4.99 (reading, no credits), Essentiel $9.90 / 120 credits, Analyste $29 / 400 credits, Pro $79 / 1,200 credits; custom plans available. Credit subscribers can buy $5 or $15 top-ups. API: pay as you go. Browser extension included from Essentiel. 13 interface languages.","contact":{"name":"Terra-OrB","email":"contact@terra-osint.com","url":"https://terra-orb.com"},"termsOfService":"https://terra-orb.com/cgv"},"servers":[{"url":"https://terra-orb.com/api/public/v1","description":"Production"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key created from a Terra-OrB account: Authorization: Bearer tm_<key>"}}},"security":[{"bearerAuth":[]}],"paths":{"/events":{"get":{"summary":"Global events","description":"Merged events reconstructed from multi-source coverage, with intensity, countries involved and source counts.","operationId":"get_events","security":[{"bearerAuth":[]}],"parameters":[{"name":"about","in":"query","required":false,"description":"ISO country code the event concerns","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"intensite | recent","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1-100, default 20","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload including generated_at.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing, unknown or revoked API key."},"402":{"description":"Credit balance exhausted."},"403":{"description":"Key scope insufficient."}}}},"/articles":{"get":{"summary":"Raw dispatches, keyword search and historical archive","description":"Latest dispatches captured from public feeds across 222 countries and territories monitored (most covered every day), with full-text keyword search, domain, date and sort controls. Requests reaching beyond the last 24 hours automatically search the historical archive of past dispatches.","operationId":"get_articles","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":false,"description":"Keyword search across title, translated title and summary","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO country code","schema":{"type":"string"}},{"name":"topic","in":"query","required":false,"description":"Topic slug","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"ISO language code","schema":{"type":"string"}},{"name":"domains","in":"query","required":false,"description":"Comma-separated media domains, e.g. reuters.com,bbc.com","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"live (last 24h) | archive (historical memory) | all (both). Defaults to live, switches to all when 'from' predates 24h","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"ISO date-time lower bound (live: max 30 days back; archive: up to 1 year)","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"ISO date-time upper bound","schema":{"type":"string"}},{"name":"sort_by","in":"query","required":false,"description":"published_at | relevance | intensity","schema":{"type":"string"}},{"name":"before","in":"query","required":false,"description":"Cursor from next_cursor","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1-200, default 100","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload including generated_at.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing, unknown or revoked API key."},"402":{"description":"Credit balance exhausted."},"403":{"description":"Key scope insufficient."}}}},"/signals":{"get":{"summary":"Early signals","description":"Weak signals detected in local press before general pickup, with measured lead time in minutes.","operationId":"get_signals","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"1-100, default 20","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload including generated_at.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing, unknown or revoked API key."},"402":{"description":"Credit balance exhausted."},"403":{"description":"Key scope insufficient."}}}},"/barometers":{"get":{"summary":"Tension barometers","description":"Tension, dispersion and lexical intensity readings per country and topic.","operationId":"get_barometers","security":[{"bearerAuth":[]}],"parameters":[{"name":"country","in":"query","required":false,"description":"ISO country code","schema":{"type":"string"}},{"name":"topic","in":"query","required":false,"description":"Topic slug","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload including generated_at.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing, unknown or revoked API key."},"402":{"description":"Credit balance exhausted."},"403":{"description":"Key scope insufficient."}}}},"/coverage":{"get":{"summary":"World coverage","description":"Media coverage status for each monitored country and territory.","operationId":"get_coverage","security":[{"bearerAuth":[]}],"parameters":[{"name":"country","in":"query","required":false,"description":"ISO country code","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload including generated_at.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing, unknown or revoked API key."},"402":{"description":"Credit balance exhausted."},"403":{"description":"Key scope insufficient."}}}},"/sources":{"get":{"summary":"Media directory","description":"Directory of tracked outlets with country, language, form and captured volume.","operationId":"get_sources","security":[{"bearerAuth":[]}],"parameters":[{"name":"country","in":"query","required":false,"description":"ISO country code","schema":{"type":"string"}},{"name":"before","in":"query","required":false,"description":"Cursor from next_cursor","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload including generated_at.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing, unknown or revoked API key."},"402":{"description":"Credit balance exhausted."},"403":{"description":"Key scope insufficient."}}}},"/ask":{"get":{"summary":"AI investigation","description":"Runs a Terra-OrB investigation: sourced synthesis, four-sphere prism, reliability audit and quantified impact chain. Requires a full-access key.","operationId":"get_ask","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":false,"description":"The question, free text","schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"description":"rapide | profond","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON payload including generated_at.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Missing, unknown or revoked API key."},"402":{"description":"Credit balance exhausted."},"403":{"description":"Key scope insufficient."}}}}},"externalDocs":{"description":"Documentation","url":"https://terra-orb.com/api-docs"}}