Skip to main content
POST
ملخصات توسع الشركات الدفعية

التفويضات

pubrio-api-key
string
header
مطلوب

رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات والعمليات المقابلة. يمكنك إنشاءه عبر قسم Settings.

الجسم

application/json

حدّد نطاق الشركات بمصفوفة companies واحدة من معرّفات مختلطة — domain_search_id، أو نطاق الشركة، أو رابط LinkedIn — تُطابَق كاتحاد (لا تقاطع). لا تزال المفاتيح القديمة domain_search_ids وdomains وlinkedin_urls مقبولة للتوافق الخلفي. حتى 25 شركة محلولة لكل طلب.

companies
string[]

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

مثال:
domains
string[]

قائمة نطاقات شركات تُستخدَم لعمليات البحث عن شركات وأشخاص. إن استلمنا رابطًا مثل www.pubrio.com أو https://docs.pubrio.com/، سيحوّله النظام إلى pubrio.com للمعالجة.

مثال:
linkedin_urls
string[]

الرابط الكامل لملف شركة على LinkedIn. يبدأ الرابط بـhttp ويحتوي linkedin.com/company/

مثال:
transitioned_dates
string<date>[]

نطاق تاريخ ISO [من, إلى] لنافذة الإشارة/الانتقال. له الأولوية على window_days عند توفير كليهما.

مثال:
window_days
integer

اختياري. حجم النافذة المتحركة بالأيام. يُستخدَم عندما لا يُوفَّر نطاق transitioned_dates صريح؛ إن حُذف كلاهما، تُستخدَم نافذة افتراضية.

مثال:

90

is_include_established
boolean

أدرِج مرحلة established (المشغّلون العريقون دون إشارات توسع نشطة). الافتراضي false.

مثال:

false

is_include_metadata
boolean

أعِد حمولة التفاصيل الكاملة. حركة مرور مفتاح API مختصرة افتراضيًا: تُحذَف كتلة model، وأرقام الثقة (stage.confidence في تفاصيل توسع الشركة، وconfidence_score في other_markets[] وفي markers[] الخاصة بالتصنيفات)، وحقول established_min / share_of_detected / has_known_office ما لم تكن هذه بقيمة true.

مثال:

true

الاستجابة

مصفوفة من ملخصات توسع لكل شركة. درجتان: expansion_score في المستوى الأعلى هو الوضع الحالي الإجمالي عبر كل الأسواق (ثابت)؛ وsummary.window_expansion_score هو نفس المقياس محدَّد النطاق بالنافذة المختارة. كلاهما على مقياس من 0 إلى 100 هنا (بخلاف stage.expansion_score من 0 إلى 1 في نتائج البحث). عندما لا تشمل خطتك عدد الموظفين، تُعيد firmographics القيم company_size وemployees_count وcompany_size_printed كـ null وتضبط is_employees_locked: true.

metadata
object
data
object
آخر تعديل في ٤ سبتمبر ٢٠٢٦