Terra-Orb API'si
Terra-Orb'un tüm canlı verileri (olaylar, makaleler, erken sinyaller, barometreler, küresel kapsam) Terra-OSINT'i veya diğer herhangi bir analiz aracını desteklemek için JSON'da, salt okunurdur. Her makale, tam metni, özeti, orijinal URL'si, yayıncısı ve kesin tarihleriyle birlikte gelir; /ask, güvendiği her kaynağın alıntısını döndürür.
Kesin sonuçlar için en iyi uygulamalar
- · Kısa anahtar kelimeler gönderin (varlıklar + anahtar terimler), ör.
q=Süveyş Bask atık suyu, tam bir başlık yerine. Uzun sorgular otomatik olarak en belirgin 5 kelimeye indirgenir (stopwords kaldırıldı); yanıt onları gösteriyorquery_terms. - · Kullanmak
/makalelergerçek basın kapsamı için (tam metin, tarih, kaynak alan adı)./sinyallerküresel bir erken uyarı akışıdır: her zaman başarılı olunqyalnızca eşleşen sinyalleri tutmak için. - · Sorgu
/makaleler,/olaylarVe/sinyallerparalel olarak, görüntülemeden önce kendi alaka düzeyi eşiğinizi (örneğin, referans başlığınıza benzerlik ≥ 0,25) uygulayın.
Erişim ve fiyatlandırma
API ücretli hizmetin bir parçasıdır: anahtar bir Terra-Orb hesabından oluşturulur ve yalnızca çağrıldığı günlerde kredi olarak faturalandırılır.
- · 30 kullanım günü başına kredi, 1,000 istekleri yer alıyor.
- · 10 blok başına kredi 1,000 bunun ötesinde talepler var.
- · API kullandıkça öder; okuma ve araştırma abonelikleri ayrıdır.
| Pazar teklifi | Fiyatı | Hacim | Terra-OrB |
|---|---|---|---|
| TheNewsAPI / MediaStack Standardı | 99$/ay | 10.000 ila 30.000 istek | ≈ 72 $ / ay |
| MediaStack Profesyoneli | 249$/ay | 50.000 istek | ≈ 184 $ / ay |
| HaberlerAPI Business | 449$/ay | 250.000 istek | ≈ 332$ / ay |
Eşit hacimde, Terra-OrB'nin maliyeti bu aboneliklerden yaklaşık %20 daha azdır ve herhangi bir aylık taahhüt yoktur: İngilizce yayın yapan çeşitli satış noktaları yerine yalnızca gerçekten çağrıldığınız ve izlenen 222 ülke ve bölgede (çoğu her gün kapsanmaktadır) günler için ödeme yaparsınız.
İnteraktif oyun alanı
Bir örnek seçin veya isteği düzenleyin, anahtarınızı yapıştırın ve canlı JSON'u görün. Anahtarınız bu tarayıcı sekmesinde kalır ve hiçbir zaman saklanmaz. Aramalar da diğerleri gibi kullanımınıza sayılır.
curl -H "Yetkilendirme: Taşıyıcı $TERRA_ORB_KEY" \ "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5"
Uç noktalar
Temel: /api/genel/v1 — tüm yanıtlar JSON'dadır ve şunları içerir: created_at.
/api/genel/v1/olaylar— OlaylarSon 24 saatteki birleştirilmiş olaylar: kesin/yaklaşık tarihler, yayın yapan ve ilgili ülkeler, diller, yayın ve makale sayısı, üslup, yoğunluk.
Parametreler: konu, yayıcı=FR, hakkında=IR, arama, sıralama=medya|son|tarih|yoğunluk, limit≤300
/api/genel/v1/olaylar/{id}— Etkinlik ayrıntısıTam kayıt: kapsam dökümü (sahiplik, yönlendirme, ülke, dil) ve ilgili makaleler.
Parametreler: hiçbiri
/api/genel/v1/makaleler— Ham makalelerSon 24 saate ait makaleler: başlık, standart URL, etkinlik tarihi ve yayın tarihi, ülke, konu, üslup, çıkış türü (dijital/radyo/TV/basılı), sosyal ağ.
Parametreler: q (tam metin), başlangıç/bitiş (ISO tarihleri), kapsam=canlı|arşiv|tümü (arşiv ≈ 1 yıl), konu, yayıcı, hakkında, dil=fr, form=dijital|radyo|tv|baskı, önce=<tarih ISO> (sayfalandırma imleci), limit≤200
/api/genel/v1/sormak— AI yanıt motoru (tam anahtar)Serbest biçimli soru: Terra-OrB arşivi, ardından genel web, eleştirel muhakeme, alıntılanan özet [n], 4 alanlı etki matrisi, kaynaklar, takipler.
Parametreler: GET ?q=...&mode=fast|deep veya POST JSON {soru, mod}
/api/genel/v1/sinyaller— Erken sinyallerGeniş görünürlükten önce tespit edilen olaylar: durum, güven, hızlanma oranı, teslim süresi ve küresel istatistikler.
Parametreler: q (anahtar kelimeler, tümü eşleşmelidir), durum=algılama|onayla|tekrarlama, limit≤300
/api/genel/v1/barometre— BarometrelerKonuya, ülkeye ve dile göre çapraz referanslı frekans ve üslup: hacim, çıkışlar, duygu, yoğunluk, gerilim, durum düzeyi.
Parametreler: hiçbiri
/api/genel/v1/kapsam— Küresel kapsamÜlkeye göre durumu yakalayın: aktif yayınlar, son makaleler, diller, durum (kapsanıyor / zayıf / eksik / yerel yayın yok).
Parametreler: hiçbiri
/api/genel/v1/kaynaklar— Medya diziniAktif satış noktaları: isim, ülke, dil, tür, kanal (yayın, sayfa, sosyal ağ), belgelenmiş sahiplik ve yönlendirme, güvenilirlik.
Parametreler: ülke=FR, dil=ar, form=tv, tür=medya|sosyal, önce=<id> (sayfalandırma imleci), limit≤500
Örnek
curl -H "Yetkilendirme: Taşıyıcı tm_votre_cle" \ "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20"
Hata kodları: 401 (anahtar eksik, bilinmiyor veya iptal edildi), 402 (krediler tükendi), 400 (geçersiz parametreler), 404 (kaynak bulunamadı). Makalelerin ve kaynakların sayfalandırılmasında imleç kullanılır: değeri geri gönderin sonraki_imleç parametrede önce.