Terra-Orb-API

Alle live gegevens van Terra-Orb – gebeurtenissen, artikelen, vroege signalen, barometers, wereldwijde dekking – in JSON, alleen-lezen, om Terra-OSINT of een ander analysehulpmiddel aan te drijven. Elk artikel wordt geleverd met de volledige vastgelegde tekst, samenvatting, originele URL, uitgever en exacte data; /ask retourneert het uittreksel van elke bron waarop het zich baseerde.

Best practices voor nauwkeurige resultaten

· Stuur korte trefwoorden (entiteiten + sleuteltermen), b.v. q=Suez Baskisch afvalwater, in plaats van een volledige kop. Lange zoekopdrachten worden automatisch teruggebracht tot de vijf meest onderscheidende woorden (stopwoorden verwijderd); het antwoord laat ze zien query_terms.
· Gebruik /artikelen voor echte berichtgeving in de pers (volledige tekst, datum, brondomein). / signalen is een wereldwijde waarschuwingsfeed: passeer altijd q om alleen overeenkomende signalen te behouden.
· Vraag /artikelen, /evenementen En / signalen parallel, pas dan uw eigen relevantiedrempel toe (bijvoorbeeld gelijkenis ≥ 0,25 met uw referentietitel) vóór weergave.

Toegang en prijzen

De API maakt deel uit van de betaalde dienst: de sleutel wordt aangemaakt vanuit een Terra-Orb-account en wordt gefactureerd in credits, alleen op de dagen waarop deze wordt aangeroepen.

· 30 credits per gebruiksdag, met 1,000 verzoeken inbegrepen.
· 10 credits per blok van 1,000 verzoeken daarbuiten.
· API-pay-as-you-go; lees- en onderzoekabonnementen zijn gescheiden.

Markt aanbod	De prijs	Volume	Terra-OrB
TheNewsAPI / MediaStack-standaard	$ 99/maand	10.000 tot 30.000 aanvragen	≈ $ 72 / maand
MediaStack Professioneel	$ 249/maand	50.000 verzoeken	≈ $ 184 / maand
NieuwsAPI Business	$ 449/maand	250.000 verzoeken	≈ $332/maand

Bij een gelijk volume kost Terra-OrB ongeveer 20% minder dan deze abonnementen, zonder maandelijkse verplichtingen: u betaalt alleen voor de daadwerkelijk gebelde dagen, en wordt in 222 landen en gebieden gemonitord (de meeste worden elke dag gedekt) in plaats van een selectie van Engelstalige verkooppunten.

Maak mijn sleutel Mijn tegoeden opwaarderen

Interactieve speeltuin

Kies een voorbeeld of bewerk het verzoek, plak uw sleutel en bekijk de live JSON. Uw sleutel blijft op dit browsertabblad staan en wordt nooit opgeslagen. Oproepen tellen net als alle andere gesprekken mee voor uw verbruik.

KRIJGEN /api/public/v1

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

Eindpunten

Baseren: /api/public/v1 — alle antwoorden zijn in JSON en bevatten gegenereerd_at.

KRIJGEN/api/public/v1/evenementen— Evenementen

Samengevoegde gebeurtenissen van de afgelopen 24 uur: exacte/geschatte data, uitzendende en betrokken landen, talen, aantal verkooppunten en artikelen, toon, intensiteit.

Parameters: onderwerp, zender=FR, about=IR, zoeken, sort=media|recent|datum|intensief, limiet≤300

KRIJGEN/api/public/v1/evenementen/{id}— Evenementdetails

Volledig overzicht: uitsplitsing van de dekking (eigendom, oriëntatie, land, taal) en gerelateerde artikelen.

Parameters: geen

KRIJGEN/api/public/v1/artikelen— Ruwe artikelen

Artikelen van de afgelopen 24 uur: titel, canonieke URL, datum van het evenement vs. publicatiedatum, land, onderwerp, toon, type outlet (digitaal/radio/TV/print), sociaal netwerk.

KRIJGEN/api/public/v1/vragen— AI-antwoordengine (volledige sleutel)

Vraag in vrije vorm: Terra-OrB-archief en vervolgens openbaar web, kritische redenering, geciteerde samenvatting [n], impactmatrix met 4 domeinen, bronnen, vervolgacties.

Parameters: GET ?q=...&mode=fast|deep, of POST JSON {vraag, modus}

KRIJGEN/api/public/v1/ signalen— Vroege signalen

Gebeurtenissen gedetecteerd vóór brede zichtbaarheid: status, vertrouwen, acceleratiesnelheid, doorlooptijd, plus wereldwijde statistieken.

Parameters: q (trefwoorden, ze moeten allemaal overeenkomen), status=detecte|confirme|repris, limit≤300

KRIJGEN/api/public/v1/barometers— Barometers

Frequentie en toon waarnaar wordt verwezen per onderwerp, land en taal: volume, verkooppunten, sentiment, intensiteit, spanning, situatieniveau.

Parameters: geen

KRIJGEN/api/public/v1/dekking— Wereldwijde dekking

Leg de status per land vast: actieve verkooppunten, recente artikelen, talen, status (bedekt / zwak / ontbrekend / geen lokaal verkooppunt).

Parameters: geen

KRIJGEN/api/public/v1/bronnen— Mediamap

Actieve verkooppunten: naam, land, taal, type, kanaal (feed, pagina, sociaal netwerk), gedocumenteerd eigendom en oriëntatie, betrouwbaarheid.

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

Voorbeeld

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

Foutcodes: 401 (sleutel ontbreekt, onbekend of ingetrokken), 402 (credits opgebruikt), 400 (ongeldige parameters), 404 (bron niet gevonden). Bij paginering van artikelen en bronnen wordt gebruik gemaakt van een cursor: stuur de waarde terug volgende_cursor in de parameter voor.