Terra-Orb API
Terra-Orb のすべてのライブ データ (イベント、記事、初期シグナル、気圧計、グローバル カバレッジ) は、読み取り専用の JSON 形式で、Terra-OSINT またはその他の分析ツールを強化します。すべての記事には、キャプチャされた完全なテキスト、概要、元の URL、発行者、および正確な日付が付属しています。 /ask は、依存した各ソースの抜粋を返します。
正確な結果を得るためのベストプラクティス
- · 短いキーワード (エンティティ + 重要な用語) を送信します。
q=スエズバスクの廃水、完全な見出しではなく。長いクエリは、最も特徴的な 5 つの単語に自動的に削減されます (ストップワードは削除されます)。応答にはそれらが表示されますクエリ用語. - ・ 使用
/記事実際の報道内容(全文、日付、ソースドメイン)。/信号はグローバル早期警告フィードです: 常に通過しますq一致する信号のみを維持します。 - · クエリ
/記事,/イベントそして/信号並行して、表示する前に独自の関連性のしきい値 (例: 参照タイトルとの類似度 ≥ 0.25) を適用します。
アクセスと料金
API は有料サービスの一部です。キーは Terra-Orb アカウントから作成され、呼び出された日にのみクレジットで請求されます。
- · 30 1 日の使用あたりのクレジット、 1,000 リクエストも含まれています。
- · 10 ブロックごとのクレジット 1,000 それ以上のリクエスト。
- · API は従量課金制です。読書と調査の購読は別のものです。
| マーケットオファー | その価格 | 音量 | Terra-OrB |
|---|---|---|---|
| TheNewsAPI / MediaStack 標準 | $99/月 | 10,000 ~ 30,000 リクエスト | ≈ 72ドル/月 |
| メディアスタックプロフェッショナル | $249/月 | 50,000 件のリクエスト | ≈ 184ドル/月 |
| ニュースAPI事業 | $449/月 | 250,000 件のリクエスト | ≈ 月額 332 ドル |
同じボリュームの場合、Terra-OrB の料金はこれらのサブスクリプションより約 20% 安くなり、月々の契約はありません。料金は、英語の販売店を選択する代わりに、実際に通話した日の料金のみで、監視対象の 222 の国と地域 (ほとんどが毎日カバーされます) に対してのみかかります。
インタラクティブな遊び場
例を選択するか、リクエストを編集し、キーを貼り付けて、ライブ JSON を確認します。キーはこのブラウザ タブに残り、保存されることはありません。通話は他の通話と同様に使用量としてカウントされます。
カール -H "権限: ベアラー $TERRA_ORB_KEY" \ 「https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5」
エンドポイント
ベース: /api/パブリック/v1 — すべての応答は JSON 形式であり、以下が含まれます 生成された_at.
/api/パブリック/v1/イベント— イベント過去 24 時間の統合されたイベント: 正確/おおよその日付、排出国と関係国、言語、報道機関と記事の数、トーン、強度。
パラメータ: トピック、エミッター=FR、約=IR、検索、ソート=メディア|最近|日付|インテンサイト、制限≤300
/api/パブリック/v1/イベント/{id}— イベント詳細完全な記録: 対象範囲の内訳 (所有権、向き、国、言語) および関連記事。
パラメータ: なし
/api/パブリック/v1/記事— 生の記事過去 24 時間の記事: タイトル、正規 URL、イベント日と発行日、国、トピック、論調、媒体の種類 (デジタル/ラジオ/テレビ/印刷物)、ソーシャル ネットワーク。
パラメータ: q (全文)、from/to (ISO 日付)、scope=live|archive|all (アーカイブ ≈ 1 年)、topic、emitter、about、 language=fr、form=digital|radio|tv|print、before=<日付 ISO> (ページネーション カーソル)、limit≤200
/api/パブリック/v1/聞く— AI回答エンジン(フルキー)自由形式の質問: Terra-OrB アーカイブ、その後パブリック Web、批判的推論、引用された要約 [n]、4 ドメインの影響マトリックス、ソース、フォローアップ。
パラメータ: GET ?q=...&mode=fast|deep、または POST JSON {question, mode}
/api/パブリック/v1/信号— 初期のシグナル広く可視化される前に検出されたイベント: ステータス、信頼性、加速率、リードタイム、およびグローバル統計。
パラメータ: q (キーワード、すべて一致する必要があります)、status=detecte|confirme|repris、limit≤300
/api/パブリック/v1/気圧計— バロメータートピック、国、言語ごとに頻度とトーンを相互参照: 音量、表現、感情、激しさ、緊張、状況レベル。
パラメータ: なし
/api/パブリック/v1/カバレッジ— 世界的なカバレッジ国別のステータスのキャプチャ: アクティブなアウトレット、最近の記事、言語、ステータス (カバーされている / 弱い / 見つからない / ローカル アウトレットなし)。
パラメータ: なし
/api/パブリック/v1/ソース— メディアディレクトリアクティブなアウトレット: 名前、国、言語、タイプ、チャネル (フィード、ページ、ソーシャル ネットワーク)、文書化された所有権と方向性、信頼性。
パラメータ: country=FR、 language=ar、form=tv、kind=media|social、before=<id> (ページネーションカーソル)、limit≤500
例
カール -H "権限: ベアラー tm_votre_cle" \ 「https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20」
エラー コード: 401 (キーが見つからない、不明または取り消されている)、402 (クレジットが使い果たされている)、400 (無効なパラメーター)、404 (リソースが見つかりません)。記事とソースのページネーションはカーソルを使用します: 値を送り返します 次のカーソル パラメータで 前に.