API Terra-Orb

Toutes les données en direct de Terra-Orb — événements, articles, premiers signaux, baromètres, couverture mondiale — en JSON, en lecture seule, pour alimenter Terra-OSINT ou tout autre outil d'analyse. Chaque article est accompagné de son texte complet capturé, de son résumé, de son URL d'origine, de son éditeur et de ses dates exactes ; /ask renvoie l'extrait de chaque source sur laquelle il s'est appuyé.

Bonnes pratiques pour des résultats précis

  • · Envoyez des mots-clés courts (entités + termes clés), par ex. q=Eaux usées basques de Suez, plutôt qu'un titre complet. Les requêtes longues sont automatiquement réduites à leurs 5 mots les plus distinctifs (mots vides supprimés) ; la réponse les montre dans termes_requête.
  • · Utiliser /articles pour une véritable couverture presse (texte intégral, date, domaine source). /signaux est un flux mondial d'alerte précoce : passez toujours q pour ne conserver que les signaux correspondants.
  • · Requête /articles, /événements et /signaux en parallèle, appliquez ensuite votre propre seuil de pertinence (ex : similarité ≥ 0,25 avec votre titre de référence) avant affichage.

Accès et tarifs

L'API fait partie du service payant : la clé est créée à partir d'un compte Terra-Orb et est facturée en crédits, uniquement les jours où elle est appelée.

  • · 30 crédits par jour d'utilisation, avec 1,000 demandes incluses.
  • · 10 crédits par bloc de 1,000 demandes au-delà de cela.
  • · API payante au fur et à mesure ; les abonnements lecture et enquête sont distincts.
Offre de marchéSon prixVolumeTerra-OrB
TheNewsAPI / MediaStack Standard99 $ / mois10 000 à 30 000 requêtes≈ $72 / mois
MediaStack Professionnel249 $ / mois50 000 requêtes≈ $184 / mois
ActualitésAPI Business449 $ / mois250 000 requêtes≈ $332 / mois

A volume égal, Terra-OrB coûte environ 20 % moins cher que ces abonnements, sans engagement mensuel : vous ne payez que les jours effectivement appelés, et sur 222 pays et territoires suivis (la plupart couverts chaque jour) au lieu d'une sélection de points de vente anglophones.

Aire de jeux interactive

Choisissez un exemple ou modifiez la demande, collez votre clé et voyez le JSON en direct. Votre clé reste dans cet onglet du navigateur et n'est jamais stockée. Les appels comptent dans votre utilisation comme les autres.

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

Points de terminaison

Base: /api/public/v1 — toutes les réponses sont en JSON et incluent généré_at.

OBTENIR/api/public/v1/événements— Événements

Evénements fusionnés des dernières 24h : dates exactes/approximatives, pays émetteurs et concernés, langues, nombre de points de vente et d'articles, ton, intensité.

Paramètres : sujet, émetteur=FR, about=IR, recherche, sort=media|recent|date|intensite, limit≤300

OBTENIR/api/public/v1/événements/{identifiant}— Détail de l'événement

Dossier complet : répartition de la couverture (propriété, orientation, pays, langue) et articles associés.

Paramètres : aucun

OBTENIR/api/public/v1/articles— Articles bruts

Articles des dernières 24h : titre, URL canonique, date de l'événement vs date de publication, pays, sujet, ton, type de support (numérique/radio/TV/print), réseau social.

Paramètres : q (texte intégral), de/à (dates ISO), scope=live|archive|all (archive ≈ 1 an), topic, émetteur, à propos, langue=fr, form=digital|radio|tv|print, before=<date ISO> (pagination curseur), limit≤200

OBTENIR/api/public/v1/demander— Moteur de réponse IA (clé complète)

Question libre : archive Terra-OrB puis web public, raisonnement critique, résumé cité [n], matrice d'impact à 4 domaines, sources, suivis.

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

OBTENIR/api/public/v1/signaux— Premiers signaux

Événements détectés avant une large visibilité : statut, confiance, taux d'accélération, délai d'exécution, ainsi que des statistiques globales.

Paramètres : q (mots clés, tous doivent correspondre), status=detecte|confirme|repris, limit≤300

OBTENIR/api/public/v1/baromètres— Baromètres

Fréquence et ton croisés par thème, pays et langue : volume, débouchés, sentiment, intensité, tension, niveau de situation.

Paramètres : aucun

OBTENIR/api/public/v1/couverture— Couverture mondiale

Capturez le statut par pays : points de vente actifs, articles récents, langues, statut (couvert / faible / manquant / pas de point de vente local).

Paramètres : aucun

OBTENIR/api/public/v1/sources— Répertoire des médias

Points de vente actifs : nom, pays, langue, type, canal (flux, page, réseau social), propriété et orientation documentées, fiabilité.

Paramètres : country=FR, langue=ar, form=tv, kind=media|social, before=<id> (pagination curseur), limit≤500

Exemple

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

Codes d'erreur : 401 (clé manquante, inconnue ou révoquée), 402 (crédits épuisés), 400 (paramètres invalides), 404 (ressource introuvable). La pagination des articles et des sources utilise un curseur : renvoyer la valeur prochain_curseur dans le paramètre avant.