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. Ваш ключ залишається на цій вкладці веб-переглядача та ніколи не зберігається. Дзвінки зараховуються до вашого використання, як і будь-які інші.

ОТРИМАТИ /api/public/v1
curl -H "Авторизація: носій $TERRA_ORB_KEY" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5"

Кінцеві точки

база: /api/public/v1 — усі відповіді містяться у форматі JSON generated_at.

ОТРИМАТИ/api/public/v1/події— Події

Об’єднані події за останні 24 години: точні/приблизні дати, країни, що видають і зацікавлені, мови, кількість видань і статей, тон, інтенсивність.

Параметри: тема, emitter=FR, about=IR, search, sort=media|recent|date|intensite, limit≤300

ОТРИМАТИ/api/public/v1/events/{id}— Подробиці події

Повний запис: розподіл покриття (власність, орієнтація, країна, мова) і пов’язані статті.

Параметри: немає

ОТРИМАТИ/api/public/v1/статті— Необроблені статті

Статті за останні 24 години: назва, канонічна URL-адреса, дата події та дата публікації, країна, тема, тон, тип виходу (цифровий/радіо/телебачення/друкований), соціальна мережа.

Параметри: q (повний текст), from/to (дати ISO), scope=live|archive|all (archive ≈ 1 year), topic, emitter, about, language=fr, form=digital|radio|tv|print, before=<date ISO> (pagination curseur), limit≤200

ОТРИМАТИ/api/public/v1/питати— Механізм відповіді AI (повний ключ)

Запитання у довільній формі: архів Terra-OrB, а потім загальнодоступна мережа, критичне міркування, цитоване резюме [n], матриця впливу з 4 доменів, джерела, подальші дії.

Параметри: GET ?q=...&mode=fast|deep або POST JSON {питання, режим}

ОТРИМАТИ/api/public/v1/сигнали— 初期のシグナル

Події, виявлені перед широкою видимістю: статус, впевненість, швидкість прискорення, час виконання, а також глобальна статистика.

Параметри: q (ключові слова, усі мають збігатися), status=detecte|confirme|repris, limit≤300

ОТРИМАТИ/api/public/v1/барометри— Барометри

Перехресні посилання на частоту та тон за темою, країною та мовою: гучність, виходи, настрої, інтенсивність, напруга, рівень ситуації.

Параметри: немає

ОТРИМАТИ/api/public/v1/покриття— Глобальне покриття

Зберігайте статуси за країнами: активні торгові точки, останні статті, мови, статус (охоплено/слабко/відсутнє/немає місцевого видання).

Параметри: немає

ОТРИМАТИ/api/public/v1/джерела— Каталог ЗМІ

Активні торгові точки: назва, країна, мова, тип, канал (стрічка, сторінка, соц. мережа), документальне право власності та орієнтація, надійність.

Параметри: country=FR, language=ar, form=tv, kind=media|social, before=<id> (курсор сторінки), limit≤500

приклад

curl -H "Авторизація: носій tm_votre_cle" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20"

Коди помилок: 401 (ключ відсутній, невідомий або відкликаний), 402 (кредити вичерпано), 400 (недійсні параметри), 404 (ресурс не знайдено). Пагінація статей і джерел використовує курсор: повернути значення наступний_курсор у параметрі раніше.