API Терра-Орб
Все текущие данные Terra-Orb — события, статьи, ранние сигналы, барометры, глобальное освещение — в формате JSON, доступны только для чтения, для поддержки Terra-OSINT или любого другого инструмента анализа. Каждая статья сопровождается полным текстом, кратким изложением, исходным URL-адресом, издателем и точными датами; /ask возвращает отрывок из каждого источника, на который он опирался.
Лучшие практики для точных результатов
- · Отправьте короткие ключевые слова (сущности + ключевые термины), например.
q = сточные воды Суэцкого баскского региона, а не полный заголовок. Длинные запросы автоматически сокращаются до 5 наиболее характерных слов (стоп-слова удаляются); ответ показывает их взапрос_термс. - · Использовать
/статьидля реального освещения в прессе (полный текст, дата, исходный домен)./сигналыэто глобальный канал раннего предупреждения: всегда проходите мимоqчтобы сохранять только совпадающие сигналы. - · Запрос
/статьи,/событияи/сигналыпараллельно, затем перед отображением примените собственный порог релевантности (например, сходство ≥ 0,25 с заголовком ссылки).
Доступ и цены
API является частью платного сервиса: ключ создается из учетной записи Terra-Orb и оплачивается в кредитах только в те дни, когда он вызывается.
- · 30 кредитов за день использования, с 1,000 запросы включены.
- · 10 кредитов за блок 1,000 запросы сверх этого.
- · Плата за API по мере использования; Подписки на чтение и исследования предоставляются отдельно.
| Рыночное предложение | Его цена | Объем | Терра-ОрБ |
|---|---|---|---|
| TheNewsAPI / Стандарт MediaStack | $99/месяц | От 10 000 до 30 000 запросов | ≈ $72/мес. |
| Медиастек Профессионал | 249 $ / mois | 50 000 requêtes | ≈ $184 / mois |
| НовостиAPI Business | 449 $ / mois | 250 000 запросов | ≈ $332 / mois |
При равном объеме Terra-OrB стоит примерно на 20% меньше, чем эти подписки, без каких-либо ежемесячных обязательств: вы платите только за фактически использованные дни и в 222 отслеживаемых странах и территориях (большая часть которых покрывается каждый день) вместо выбора англоязычных торговых точек.
Интерактивная игровая площадка
Выберите пример или отредактируйте запрос, вставьте свой ключ и посмотрите живой JSON. Ваш ключ остается на этой вкладке браузера и никогда не сохраняется. Звонки засчитываются в счет использования, как и любые другие.
curl -H "Авторизация: носитель $TERRA_ORB_KEY" \ "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5"
Конечные точки
База: /api/public/v1 — все ответы представлены в формате JSON и включают сгенерированный_at.
/api/public/v1/события— СобытияОбъединенные события за последние 24 часа: точные/приблизительные даты, страны-эмитенты и заинтересованные страны, языки, количество СМИ и статей, тон, интенсивность.
Параметры: тема, эмиттер=FR, about=IR, поиск, sort=media|последние|дата|интенсивность, предел≤300
/api/public/v1/события/{идентификатор}— Детали мероприятияПолная запись: разбивка охвата (право собственности, ориентация, страна, язык) и соответствующие статьи.
Параметры: никто
/api/public/v1/статьи— Необработанные статьиСтатьи за последние 24 часа: название, канонический URL-адрес, дата события и дата публикации, страна, тема, тон, тип СМИ (цифровое/радио/ТВ/печатное), социальная сеть.
Параметры: q (полный текст), от/до (даты ISO), область=live|архив|все (архив ≈ 1 год), тема, эмиттер, о, язык=фр, форма=цифровой|радио|тв|печать, до=<дата ISO> (курсор нумерации страниц), лимит≤200
/api/public/v1/просить— Система ответов AI (полный ключ)Вопрос в произвольной форме: архив Terra-OrB, затем общедоступная сеть, критические рассуждения, цитируемое резюме [n], 4-доменная матрица воздействия, источники, последующие действия.
Параметры: GET ?q=...&mode=fast|deep или POST JSON {вопрос, режим}
/api/public/v1/сигналы— Tín hiệu sớmСобытия, обнаруженные до того, как они станут общедоступными: статус, достоверность, скорость ускорения, время выполнения, а также глобальная статистика.
Параметры: q (ключевые слова, все должны совпадать), status=decte|confirme|repris, limit≤300
/api/public/v1/барометры— BarometersЧастота и тон перекрестных ссылок по темам, странам и языкам: громкость, направления, настроения, интенсивность, напряжение, уровень ситуации.
Параметры: никто
/api/public/v1/покрытие— Глобальный охватЗафиксируйте статус по стране: активные СМИ, последние статьи, языки, статус (охвачено/слабое/отсутствует/нет местного издания).
Параметры: никто
/api/public/v1/источники— Медиа-каталогАктивные точки: название, страна, язык, тип, канал (лента, страница, социальная сеть), документально подтвержденное право собственности и направленность, надежность.
Параметры: страна=FR, язык=AR, форма=TV, вид=медиа|социальный, before=<id> (курсор нумерации страниц), лимит≤500
Пример
curl -H "Авторизация: носитель tm_votre_cle" \ "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20"
Коды ошибок: 401 (ключ отсутствует, неизвестен или отозван), 402 (исчерпаны кредиты), 400 (неверные параметры), 404 (ресурс не найден). Для разбивки статей и источников используется курсор: отправьте значение обратно. следующий_курсор в параметре до.