تيرا-أورب 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 المباشر. يبقى مفتاحك في علامة تبويب المتصفح هذه ولا يتم تخزينه أبدًا. يتم احتساب المكالمات ضمن استخدامك مثل أي شيء آخر.
حليقة -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 في المعلمة قبل.