API Terra-Orb

Усі поточні дані Terra-Orb — події, статті, ранні сигнали, барометри, глобальне охоплення — у форматі JSON, лише для читання, для забезпечення Terra-OSINT або будь-якого іншого інструменту аналізу. Кожна стаття постачається з повним записаним текстом, резюме, оригінальною URL-адресою, видавцем і точними датами; /ask повертає уривок кожного джерела, на яке він спирався.

Найкращі практики для точних результатів

  • · Надішліть короткі ключові слова (сутності + ключові терміни), напр. q=Суецькі баскські стічні води, а не повний заголовок. Довгі запити автоматично скорочуються до 5 найбільш характерних слів (стоп-слова видалено); відповідь показує їх query_terms.
  • · Використання /статті для реального висвітлення в пресі (повний текст, дата, домен джерела). /сигнали це глобальний канал раннього попередження: завжди проходити q щоб зберегти лише відповідні сигнали.
  • · Запит /статті, /події і /сигнали паралельно, потім застосуйте свій власний поріг релевантності (наприклад, схожість ≥ 0,25 до вашої еталонної назви) перед відображенням.

Доступ і ціни

API є частиною платної послуги: ключ створюється з облікового запису Terra-Orb і виставляється в кредитах лише в дні виклику.

  • · 30 кредитів за день використання, с 1,000 включені запити.
  • · 10 кредитів на блок 1,000 запити понад це.
  • · API платить за ходом; абонемент на читання та розслідування окремо.
Ринкова пропозиціяЙого цінаОбсягTerra-OrB
TheNewsAPI / MediaStack Standard99 доларів на місяцьВід 10 000 до 30 000 запитів≈ $72 / місяць
MediaStack Professional249 доларів на місяць50 000 запитів≈ $184 / місяць
NewsAPI Бізнес$449/місяць250 000 запитів≈ $332 / місяць

За рівного обсягу Terra-OrB коштує приблизно на 20% менше, ніж ці підписки, без щомісячних зобов’язань: ви платите лише за дні, коли фактично телефонували, і в 222 країнах і територіях, які відстежуються (більшість охоплюється щодня), замість вибору англомовних торгових точок.

Створіть мій ключПоповнити мої кредити

Інтерактивний майданчик

Виберіть приклад або відредагуйте запит, вставте свій ключ і перегляньте живий JSON. Ваш ключ залишається на цій вкладці веб-переглядача та ніколи не зберігається. Дзвінки зараховуються до вашого використання, як і будь-які інші.

DOSTAWAĆ /api/public/v1
curl -H "Autoryzacja: nośnik $TERRA_ORB_KEY" \
  „https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5”

Punkty końcowe

Opierać: /api/public/v1 — wszystkie odpowiedzi są w formacie JSON i zawierają wygenerowane_at.

DOSTAWAĆ/api/public/v1/події— Wydarzenia

Połączone wydarzenia z ostatnich 24 godzin: dokładne/przybliżone daty, kraje emitujące i zainteresowane, języki, liczba punktów sprzedaży i artykułów, ton, intensywność.

Parametry: temat, emiter=FR, informacje=IR, wyszukiwanie, sort=media|ostatnie|data|intensywne, limit≤300

DOSTAWAĆ/api/public/v1/wydarzenia/{id}— Szczegóły wydarzenia

Pełny zapis: podział zasięgu (własność, orientacja, kraj, język) i powiązane artykuły.

Parametry: nic

DOSTAWAĆ/api/public/v1/статті— Surowe artykuły

Artykuły z ostatnich 24 godzin: tytuł, kanoniczny adres URL, data wydarzenia a data publikacji, kraj, temat, ton, rodzaj placówki (cyfrowa/radio/telewizja/druk), sieć społecznościowa.

Parametry: q (pełny tekst), od/do (daty ISO), zakres=live|archive|all (archiwum ≈ 1 rok), temat, emiter, about, język=fr, form=digital|radio|tv|print, before=<data ISO> (kurs paginacji), limit≤200

DOSTAWAĆ/api/public/v1/zapytać— Silnik odpowiedzi AI (pełny klucz)

Pytanie w dowolnej formie: archiwum Terra-OrB, następnie sieć publiczna, krytyczne rozumowanie, cytowane podsumowanie [n], macierz wpływu w 4 domenach, źródła, działania następcze.

Parametry: GET ?q=...&mode=fast|deep lub POST JSON {pytanie, tryb}

DOSTAWAĆ/api/public/v1/сигнали— 初期のシグナル

Zdarzenia wykryte przed szeroką widocznością: status, pewność, tempo przyspieszenia, czas realizacji oraz globalne statystyki.

Parametry: q (słowa kluczowe, wszystkie muszą pasować), status=wykryj|potwierdź|powtórz, limit≤300

DOSTAWAĆ/api/public/v1/barometry— Барометри

Powiązane częstotliwości i tony według tematu, kraju i języka: głośność, rynki zbytu, nastroje, intensywność, napięcie, poziom sytuacji.

Parametry: nic

DOSTAWAĆ/api/public/v1/zasięg— Globalny zasięg

Rejestruj status według kraju: aktywne punkty sprzedaży, najnowsze artykuły, języki, status (objęty / słaby / brak / brak lokalnego punktu sprzedaży).

Parametry: nic

DOSTAWAĆ/api/public/v1/źródła— Katalog multimediów

Aktywne rynki zbytu: nazwa, kraj, język, typ, kanał (kanał, strona, sieć społecznościowa), udokumentowana własność i orientacja, niezawodność.

Parametry: kraj=FR, język=ar, form=tv, kind=media|social, before=<id> (cureur stronicowania), limit≤500

Przykład

curl -H "Autoryzacja: nośnik tm_votre_cle" \
  „https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20”

Kody błędów: 401 (brak klucza, nieznany lub unieważniony), 402 (wyczerpane kredyty), 400 (nieprawidłowe parametry), 404 (nie znaleziono zasobu). Paginacja artykułów i źródeł wykorzystuje kursor: odeślij wartość następny_kursor w parametrze zanim.