تيرا-أورب API

جميع بيانات Terra-Orb المباشرة — الأحداث، والمقالات، والإشارات المبكرة، والمقاييس، والتغطية العالمية — بتنسيق JSON، للقراءة فقط، لتشغيل Terra-OSINT أو أي أداة تحليل أخرى. تأتي كل مقالة مع النص الكامل والملخص وعنوان URL الأصلي والناشر والتواريخ المحددة؛ /ask يُرجع مقتطفًا من كل مصدر يعتمد عليه.

أفضل الممارسات للحصول على نتائج دقيقة

  • · إرسال كلمات رئيسية قصيرة (الكيانات + المصطلحات الرئيسية)، على سبيل المثال. q=مياه الصرف الصحي في منطقة الباسك بالسويس، بدلاً من العنوان الكامل. يتم تقليل الاستعلامات الطويلة تلقائيًا إلى الكلمات الخمس الأكثر تميزًا (تمت إزالة كلمات التوقف)؛ يظهر الرد لهم في query_terms.
  • · يستخدم /articles لتغطية صحفية حقيقية (النص الكامل، التاريخ، مجال المصدر). / إشارات عبارة عن موجز عالمي للإنذار المبكر: مرر دائمًا q للحفاظ على الإشارات المطابقة فقط.
  • · استفسار /articles, /events و / إشارات بالتوازي، ثم قم بتطبيق حد الملاءمة الخاص بك (على سبيل المثال، التشابه ≥ 0.25 مع عنوانك المرجعي) قبل العرض.

الوصول والتسعير

تعد واجهة برمجة التطبيقات (API) جزءًا من الخدمة المدفوعة: يتم إنشاء المفتاح من حساب Terra-Orb ويتم محاسبته على شكل أرصدة، فقط في الأيام التي يتم الاتصال فيها.

  • · 30 الاعتمادات لكل يوم من الاستخدام، مع 1,000 الطلبات متضمنة.
  • · 10 الاعتمادات لكل كتلة من 1,000 طلبات أبعد من ذلك.
  • · API الدفع كما تذهب. اشتراكات القراءة والتحقيق منفصلة.
عرض السوقسعرهمقدارتيرا أورب
TheNewsAPI / MediaStack قياسي99 دولارًا شهريًامن 10.000 إلى 30.000 طلب≈ 72 دولارًا شهريًا
ميديا ​​ستاك بروفيشنال249 دولارًا شهريًا50.000 طلب≈ 184 دولارًا شهريًا
NewsAPI الأعمال449 دولارًا شهريًا250.000 طلب≈ 332 دولارًا شهريًا

وبحجم متساو، تبلغ تكلفة Terra-OrB حوالي 20% أقل من هذه الاشتراكات، مع عدم وجود التزام شهري: فأنت تدفع فقط مقابل الأيام التي يتم الاتصال بها فعليًا، وعبر 222 دولة ومنطقة تتم مراقبتها (معظمها يتم تغطيتها يوميًا) بدلاً من مجموعة مختارة من منافذ البيع باللغة الإنجليزية.

ملعب تفاعلي

اختر مثالاً أو قم بتحرير الطلب، ثم الصق مفتاحك وشاهد JSON المباشر. يبقى مفتاحك في علامة تبويب المتصفح هذه ولا يتم تخزينه أبدًا. يتم احتساب المكالمات ضمن استخدامك مثل أي شيء آخر.

يحصل /api/public/v1
حليقة -H "التفويض: الحامل $TERRA_ORB_KEY" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5"

نقاط النهاية

قاعدة: /api/public/v1 - جميع الاستجابات مكتوبة بتنسيق JSON وتتضمن generator_at.

يحصل/api/public/v1/events— الأحداث

الأحداث المدمجة من آخر 24 ساعة: التواريخ الدقيقة/التقريبية، البلدان المصدرة والمعنية، اللغات، عدد المنافذ والمقالات، اللهجة، الكثافة.

حدود: الموضوع، الباعث=FR، حول=IR، البحث، الفرز=الوسائط|الأخيرة|التاريخ|الكثافة، الحد ≥300

يحصل/api/public/v1/الأحداث/{المعرف}— تفاصيل الحدث

السجل الكامل: تفاصيل التغطية (الملكية، التوجه، البلد، اللغة) والمقالات ذات الصلة.

حدود: لا أحد

يحصل/api/public/v1/articles— المقالات الخام

مقالات من آخر 24 ساعة: العنوان، عنوان URL الأساسي، تاريخ الحدث مقابل تاريخ النشر، البلد، الموضوع، النغمة، نوع المنفذ (رقمي/راديو/تلفزيون/مطبوع)، شبكة التواصل الاجتماعي.

حدود: q (نص كامل)، من/إلى (تواريخ ISO)، النطاق=مباشر|أرشيف|الكل (أرشيف ≈ سنة واحدة)، الموضوع، الباعث، حول، اللغة=fr، النموذج=رقمي|راديو|تلفزيون|طباعة، قبل=<تاريخ ISO> (مؤشر ترقيم الصفحات)، الحد ≥200

يحصل/api/public/v1/بسأل— محرك الإجابة بالذكاء الاصطناعي (المفتاح الكامل)

سؤال ذو شكل حر: أرشيف Terra-OrB ثم الويب العام، والتفكير النقدي، والملخص المقتبس [n]، ومصفوفة التأثير ذات 4 مجالات، والمصادر، والمتابعات.

حدود: الحصول على ?q=...&mode=fast|deep، أو POST JSON {question, mode}

يحصل/api/public/v1/ إشارات— إشارات مبكرة

الأحداث التي تم اكتشافها قبل ظهورها على نطاق واسع: الحالة، والثقة، ومعدل التسارع، والمهلة الزمنية، بالإضافة إلى الإحصائيات العالمية.

حدود: q (الكلمات الرئيسية، يجب أن تتطابق جميعها)، الحالة=الكشف|التأكيد|التكرار، الحد ≥300

يحصل/api/public/v1/ البارومترات— البارومترات

التردد والنبرة المرجعية حسب الموضوع والبلد واللغة: الحجم، والمنافذ، والمشاعر، والحدة، والتوتر، ومستوى الموقف.

حدود: لا أحد

يحصل/api/public/v1/ التغطية— التغطية العالمية

التقاط الحالة حسب البلد: المنافذ النشطة والمقالات الحديثة واللغات والحالة (مغطاة / ضعيفة / مفقودة / لا يوجد منفذ محلي).

حدود: لا أحد

يحصل/api/public/v1/مصادر— دليل الوسائط

المنافذ النشطة: الاسم، البلد، اللغة، النوع، القناة (الخلاصة، الصفحة، الشبكة الاجتماعية)، الملكية الموثقة والتوجه، والموثوقية.

حدود: البلد=FR، اللغة=ar، النموذج=تلفزيون، النوع=وسائط|اجتماعي، قبل=<id> (مؤشر الصفحات)، الحد ≥500

مثال

حليقة -H "التفويض: الحامل tm_votre_cle" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20"

رموز الخطأ: 401 (المفتاح مفقود أو غير معروف أو تم إبطاله)، 402 (استنفدت الاعتمادات)، 400 (معلمات غير صالحة)، 404 (لم يتم العثور على المورد). يستخدم ترقيم الصفحات للمقالات والمصادر المؤشر: أرسل القيمة مرة أخرى next_cursor في المعلمة قبل.