API Terra-Orb

Tutti i dati in tempo reale di Terra-Orb (eventi, articoli, primi segnali, barometri, copertura globale) in JSON, di sola lettura, per alimentare Terra-OSINT o qualsiasi altro strumento di analisi. Ogni articolo viene fornito con il testo completo, il riepilogo, l'URL originale, l'editore e le date esatte; /ask restituisce l'estratto di ciascuna fonte su cui si basava.

Migliori pratiche per risultati precisi

· Invia parole chiave brevi (entità + termini chiave), ad es. q=Acque reflue basche di Suez, piuttosto che un titolo completo. Le query lunghe vengono ridotte automaticamente alle 5 parole più distintive (le stopword vengono rimosse); la risposta li mostra query_terms.
· Utilizzo /articoli per una copertura stampa reale (testo completo, data, dominio di origine). /segnali è un feed di allarme globale: passa sempre q per mantenere solo i segnali corrispondenti.
· Domanda /articoli, /eventi E /segnali in parallelo, quindi applica la tua soglia di pertinenza (ad esempio somiglianza ≥ 0,25 al titolo di riferimento) prima della visualizzazione.

Accesso e prezzi

L'API fa parte del servizio a pagamento: la chiave viene creata da un account Terra-Orb e viene fatturata in crediti, solo nei giorni in cui viene richiamata.

· 30 crediti per giorno di utilizzo, con 1,000 richieste incluse.
· 10 crediti per blocco di 1,000 richieste oltre a ciò.
· Pagamento API in base al consumo; gli abbonamenti alla lettura e all'approfondimento sono separati.

Offerta di mercato	Il suo prezzo	Volume	Terra-OrB
TheNewsAPI/MediaStack Standard	$99/mese	Da 10.000 a 30.000 richieste	≈ $ 72 / mese
MediaStack professionale	$ 249/mese	50.000 richieste	≈ $ 184 / mese
Affari NewsAPI	$449/mese	250.000 richieste	≈ $ 332 / mese

A parità di volume, Terra-OrB costa circa il 20% in meno rispetto a questi abbonamenti, senza impegno mensile: si paga solo per i giorni effettivamente chiamati e in 222 paesi e territori monitorati (la maggior parte coperti ogni giorno) invece di una selezione di punti vendita in lingua inglese.

Crea la mia chiave Ricarica i miei crediti

Parco giochi interattivo

Scegli un esempio o modifica la richiesta, incolla la chiave e visualizza il JSON live. La tua chiave rimane in questa scheda del browser e non viene mai memorizzata. Le chiamate contano ai fini del tuo utilizzo come qualsiasi altra.

OTTENERE /api/public/v1

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

Endpoint

Base: /api/public/v1 — tutte le risposte sono in JSON e includono generato_at.

OTTENERE/api/public/v1/eventi— Eventi

Eventi riuniti delle ultime 24 ore: date esatte/approssimative, paesi emittenti e interessati, lingue, numero di punti vendita e articoli, tono, intensità.

parametri: argomento, emettitore=FR, informazioni=IR, ricerca, ordinamento=media|recente|data|intenso, limite≤300

OTTENERE/api/public/v1/eventi/{id}— Dettaglio dell'evento

Scheda completa: ripartizione della copertura (proprietà, orientamento, paese, lingua) e articoli correlati.

parametri: nessuno

OTTENERE/api/public/v1/articoli— Articoli grezzi

Articoli delle ultime 24 ore: titolo, URL canonico, data evento rispetto a data di pubblicazione, paese, argomento, tono, tipo di uscita (digitale/radio/TV/stampa), social network.

OTTENERE/api/public/v1/chiedere— Motore di risposta AI (chiave completa)

Domanda in forma libera: archivio Terra-OrB poi web pubblico, ragionamento critico, riassunto citato [n], matrice di impatto a 4 domini, fonti, follow-up.

parametri: GET ?q=...&mode=fast|deep o POST JSON {domanda, modalità}

OTTENERE/api/public/v1/segnali— Primi segnali

Eventi rilevati prima di un'ampia visibilità: stato, confidenza, tasso di accelerazione, tempi di consegna, oltre a statistiche globali.

parametri: q (parole chiave, devono corrispondere tutte), status=detecte|confirme|repris, limit≤300

OTTENERE/api/public/v1/barometri— Barometri

Frequenza e tono dei riferimenti incrociati per argomento, paese e lingua: volume, sbocchi, sentimento, intensità, tensione, livello della situazione.

parametri: nessuno

OTTENERE/api/public/v1/copertura— Copertura globale

Cattura lo stato per paese: punti vendita attivi, articoli recenti, lingue, stato (coperto / debole / mancante / nessun punto vendita locale).

parametri: nessuno

OTTENERE/api/public/v1/fonti— Directory multimediale

Punti attivi: nome, paese, lingua, tipologia, canale (feed, pagina, social network), proprietà e orientamento documentati, affidabilità.

parametri: country=FR, lingua=ar, form=tv, kind=media|social, before=<id> (cursore impaginazione), limit≤500

Esempio

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

Codici errore: 401 (chiave mancante, sconosciuta o revocata), 402 (crediti esauriti), 400 (parametri non validi), 404 (risorsa non trovata). L'impaginazione di articoli e fonti utilizza un cursore: restituisce il valore cursore_successivo nel parametro Prima.