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 danstermes_requête. - · Utiliser
/articlespour une véritable couverture presse (texte intégral, date, domaine source)./signauxest un flux mondial d'alerte précoce : passez toujoursqpour ne conserver que les signaux correspondants. - · Requête
/articles,/événementset/signauxen 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 prix | Volume | Terra-OrB |
|---|---|---|---|
| TheNewsAPI / MediaStack Standard | 99 $ / mois | 10 000 à 30 000 requêtes | ≈ $72 / mois |
| MediaStack Professionnel | 249 $ / mois | 50 000 requêtes | ≈ $184 / mois |
| ActualitésAPI Business | 449 $ / mois | 250 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.
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.
/api/public/v1/événements— ÉvénementsEvé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
/api/public/v1/événements/{identifiant}— Détail de l'événementDossier complet : répartition de la couverture (propriété, orientation, pays, langue) et articles associés.
Paramètres : aucun
/api/public/v1/articles— Articles brutsArticles 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
/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}
/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
/api/public/v1/baromètres— BaromètresFréquence et ton croisés par thème, pays et langue : volume, débouchés, sentiment, intensité, tension, niveau de situation.
Paramètres : aucun
/api/public/v1/couverture— Couverture mondialeCapturez 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
/api/public/v1/sources— Répertoire des médiasPoints 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.