للمطوّرين
واجهة برمجة البيانات
تعيد واجهة برمجة البيانات من INSIGHTEX ملفات الشركات العامة مع مؤشرات موثّقة، لتقرأ أدواتك البيانات نفسها التي تراها في الدليل.
تلخّص المؤشرات إشارات مرصودة علنًا بصيغ ثابتة وموثّقة. وهي ليست تنبؤات ولا تصنيفات ولا نصائح استثمارية.
من يمكنه استخدامها
واجهة برمجة البيانات والتصدير المجمّع متاحان ضمن مساحات عمل Enterprise.
المصادقة
أنشئ رمزًا من صفحة واجهة برمجة البيانات، ثم أرسله في ترويسة Authorization بصيغة Bearer، أو في ترويسة X-Api-Key. تعمل أيضًا جلسة المتصفح التي سجّلت الدخول فيها.
لا تضع الرمز في عنوان URL أبدًا. تُرفض الطلبات التي تحمل رمزًا في سلسلة الاستعلام.
مثال على طلب
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://www.insightex.si/api/v1/data/organizations?limit=50&country=US&updated_since=2026-01-01"نقاط النهاية
GET /api/v1/data/organizations- تعيد صفحة واحدة من المؤسسات بصيغة JSON أو CSV.
GET /api/v1/data/organizations/export- تعيد كل المؤسسات المطابقة في ملف CSV أو JSON واحد يُرسل بالتدفق.
المعاملات
| المعامل | الوصف |
|---|---|
limit | عدد الصفوف في الصفحة، من 1 إلى 100. القيمة الافتراضية 50. |
cursor | قيمة meta.next_cursor من الصفحة السابقة. لا تُرسلها مع الصفحة الأولى. |
country | رموز دول من حرفين (ISO 3166-1 alpha-2) تفصل بينها فواصل، حتى 20 رمزًا. |
sector | معرّفات قطاعات تفصل بينها فواصل، حتى 20 معرّفًا. |
q | اسم المؤسسة يحتوي على هذا النص (من 2 إلى 100 حرف، دون تمييز حالة الأحرف). |
updated_since | تاريخ أو تاريخ ووقت بصيغة ISO 8601. تعيد المؤسسات التي تغيّر ملفها أو إشاراتها أو جولات تمويلها أو مقاييسها منذ ذلك الحين. |
format | json (الافتراضي) أو csv. |
التنقل بين الصفحات
تُرتّب النتائج حسب معرّف المؤسسة. تابع meta.next_cursor أو links.next حتى تصبح القيمة null. لا تظهر أي مؤسسة مرتين.
حقول الاستجابة
organization- الاسم والمعرّف والنوع والموقع ورابط الملف والقطاعات والدول.
indicators- funding_activity وteam_growth وproduct_launch_cadence وsignal_score_30d. لكل مؤشر درجة ومستوى ثقة ومعرّف طريقة وتعليل والأدلة التي يستند إليها.
preference_match- مدى تطابق المؤسسة مع تفضيلات القطاع والسوق في مساحة عملك.
updated_at- آخر مرة تغيّر فيها ملف المؤسسة.
طرق حساب المؤشرات
يستخدم كل مؤشر صيغة ثابتة. عند غياب الأدلة تكون الدرجة ومستوى الثقة null بدلًا من التخمين.
funding_activity.v1- جولات التمويل المؤرّخة المعلنة خلال آخر 365 يومًا وإشارات التمويل خلال آخر 180 يومًا. الدرجة = min(95, 20 + 5 × مجموع درجات الإشارات + 12 × عدد الجولات). لا تُحتسب الجولات غير المؤرّخة أبدًا.
team_growth.v1- التغيّر السنوي بين أول وآخر عدد موظفين مؤرّخ. المعدل = ((الأخير − الأول) ÷ الأول) × 365 ÷ عدد الأيام بينهما؛ الدرجة = 50 + 25 × المعدل، ضمن النطاق من 5 إلى 95. تكون null إذا وُجدت قيمة واحدة فقط، أو كانت القيمة الأولى صفرًا، أو كانت المدة أقل من 30 يومًا.
product_launch_cadence.v1- إشارات الإطلاق والإصدارات خلال آخر 90 يومًا. الدرجة = min(95, 20 + 14 × عدد الإشارات + 3 × مجموع درجات الإشارات). تكون null إذا لم توجد إشارات.
signal_score_30d- مجموع درجات كل الإشارات خلال آخر 30 يومًا.
preference_match.v1- نسبة تفضيلات القطاع والدولة التي حدّدتها وتطابق المؤسسة: 0 أو 50 أو 100. تكون null إذا لم تحدّد أيًا منها.
تلخّص المؤشرات إشارات مرصودة علنًا بصيغ ثابتة وموثّقة. وهي ليست تنبؤات ولا تصنيفات ولا نصائح استثمارية.
حدود الاستخدام
120 طلبًا في الدقيقة لكل عضو مهما كان عدد الرموز، و10 عمليات تصدير كاملة في الساعة. تحمل الاستجابات ترويستي X-RateLimit-Limit وX-RateLimit-Remaining.
الأخطاء
400: أُرسل رمز في عنوان URL. 401: الرمز مفقود أو غير صالح أو منتهي الصلاحية أو ملغى. 402: مساحة العمل لا تشمل واجهة برمجة البيانات. 403: لا يحق للرمز استخدام نقطة النهاية هذه. 422: أحد المعاملات غير صالح. 429: طلبات كثيرة جدًا؛ انتظر المدة المحددة في Retry-After.
الإصدارات
تحمل كل استجابة ترويسة X-Insightex-Api-Version. عندما تتغيّر صيغة يتغيّر معرّف طريقتها أيضًا، مثلًا من .v1 إلى .v2. تبقى نقطة النهاية الأقدم /api/data-products/organizations متاحة للتوافق.