Skip to main content
POST
البحث عن شركات مماثلة (lookalike)

التفويضات

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

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

الجسم

application/json
domain_search_id
string<uuid>
مطلوب

معرّف فريد لعملية البحث عن شركات.

locations
string[]

يُستخدَم ISO 3166-1 alpha-2 (cca2) لتصفية المواقع. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
exclude_locations
string[]

يُستخدَم ISO 3166-1 alpha-2 (cca2) لاستبعاد المواقع التي لا يلزم إعادتها. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
technologies
integer[]

قائمة من tag_id تُستخدَم للبحث عن تقنيات محددة تستخدمها الشركات. لإيجاد المعرّف، استدعِ نقطة technology تحت تبويب Filters.

يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["Shopify"].

categories
integer[]

قائمة من category_id تُستخدَم للبحث عن فئات محددة من التقنيات التي تستخدمها الشركات. لإيجاد المعرّف، استدعِ نقطة category تحت تبويب Filters.

يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["CDN"].

verticals
integer[]

قائمة من vertical_id تُستخدَم للبحث عن شركات في قطاع أو صناعة محددة. لإيجاد المعرّف، استدعِ نقطة vertical تحت تبويب Filters.

يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["AI"].

vertical_categories
integer[]

قائمة من vertical_category_id تُستخدَم للبحث عن شركات في فئة قطاع محددة. لإيجاد المعرّف، استدعِ نقطة vertical category تحت تبويب Filters.

يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["Information Technology"].

vertical_sub_categories
integer[]

قائمة من vertical_sub_category_id تُستخدَم للبحث عن شركات في فئة فرعية محددة لقطاع. لإيجاد المعرّف، استدعِ نقطة vertical sub category تحت تبويب Filters.

يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["Software"].

domain
string

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

مثال:

"pubrio.com"

linkedin_url
string

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

مثال:

"https://www.linkedin.com/company/pubrio"

employees
string[][]

نطاق عدد الموظفين العاملين في الشركة. يتيح لك هذا إيجاد شركات بناءً على عدد الموظفين. يمكنك إضافة نطاقات متعددة لتوسيع نتائج بحثك.

راجع نقاط company size تحت تبويب Filters لمزيد من المعلومات.

مثال:
founded_dates
integer[]

نطاق سنوات تأسيس الشركة. القيمة القصوى للتأسيس هي السنة الحالية.

مثال:
revenues
integer[]

الحد الأدنى والأقصى لنطاق إيرادات الشركة.

مثال:
job_locations
string[]

يُستخدَم ISO 3166-1 alpha-2 (cca2) لتصفية المواقع. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
job_posted_dates
string[]

نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك.

مثال:
job_titles
string[]

المسميات الوظيفية المرتبطة بالأفراد الذين تهدف إلى تحديدهم.

ستشمل النتائج أيضًا مسميات وظيفية تحتوي مصطلحات مشابهة، حتى لو لم تطابق تمامًا. مثلًا، البحث عن software engineer قد يُظهر نتائج لأفراد بمسمى senior software engineer.

مثال:
news_categories
string[]

قائمة من category slugs للبحث عن فئات أخبار محددة. لإيجاد اسم قياسي، استدعِ نقطة news categories تحت تبويب Filters.

مثال:
news_published_dates
string[]

نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك.

مثال:

عند التفعيل، يمكن ملء المرشحات المذكورة أعلاه التي تدعم بحث التشابه بنص حر لمعرّفات محددة.

similarity_score
number<float>

يُستخدَم مع is_enable_similarity_search. يُستخدَم هذا الرقم لتحليل ما إذا كان اسم قياسي محدد (مثل قطاع صناعي، تقنية) مشابهًا لمدخل المستخدم، وكلما زاد الرقم، زادت الصرامة.

مثال:

0.7

per_page
integer
افتراضي:25

السجلات لكل صفحة. القيمة الافتراضية 25، وهي أيضًا السقف في معظم الخطط — الحد هو max_search_per_page الخاص باشتراكك، الذي تُعيده Profile. تجاوزه يُعيد HTTP 416 برمز 41676 (أو 41613 في بحث الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة.

النطاق المطلوب: x <= 25
مثال:

25

page
integer
افتراضي:1

رقم الصفحة، بدءًا من 1. السقف هو max_search_page الخاص باشتراكك (max_company_search_page لبحث الشركات)، الذي تُعيده Profile. تجاوزه يُعيد HTTP 416.

مثال:

1

الاستجابة

استجابة ناجحة تحتوي على تفاصيل البحث عن الشركات.

metadata
object

سياق الطلب. يحمل filters وparameters المُعادة، وكتلة profile تحوي credit وtopup_credit وtotal_credit_cost — وهي المحاسبة الوحيدة للأرصدة لكل استدعاء التي تُعيدها الواجهة.

data
object | null

تعتمد معلومات الاستجابة على النقطة الطرفية المحددة.

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