Skip to main content
POST
البحث عن أشخاص

التفويضات

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

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

الجسم

application/json
search_term
string

سلسلة من الكلمات نريد تصفية النتائج بها.

مثال:

"pubrio"

people_name
string

صفِّ نتائج البحث لتشمل اسم شخص محدد.

مثال:

"king"

people_titles
string[]

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

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

مثال:
exclude_people_titles
string[]

المسميات الوظيفية المراد استبعادها. نفس المطابقة على مستوى الكلمة كما في people_titles، بحيث تزيل ["senior"] كل مسمى يحتوي تلك الكلمة. تُطبَّق بعد people_titles.

مثال:
peoples
string<uuid>[]

قائمة من معرّفات فريدة (people_search_id) تُستخدَم لعمليات البحث عن أشخاص.

management_levels
enum<string>[]

المستوى الإداري للشخص. الاسم القياسي للإدارة العليا هو c_suite وليس c_level. الاسم القياسي غير المعروف لا يطابق أحدًا. القائمة الكاملة من نقطة management level تحت Filters.

الخيارات المتاحة:
c_suite,
director,
entry,
founder,
head,
intern,
manager,
owner,
partner,
senior,
vp
مثال:
departments
string[]

يمكن أن يبحث حقل القسم عن أشخاص في مجالات خبرة محددة.

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

مثال:
exclude_departments
string[]

الأسماء القياسية للأقسام المراد استبعادها. نفس مفردات departments. يُبقى على الأشخاص الذين لا قسم مسجَّل لهم.

مثال:
department_functions
string[]

يمكن أن يحدد حقل مرشح الوظائف الأساسية أدوارًا أو مجالات خبرة معينة عند البحث عن أشخاص.

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

مثال:
exclude_department_functions
string[]

الأسماء القياسية للوظائف الأساسية المراد استبعادها. نفس مفردات department_functions. يُبقى على الأشخاص الذين لا وظيفة أساسية مسجَّلة لهم.

مثال:
employees
string[][]

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

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

مثال:
people_locations
string[]

الموقع الذي يقيم فيه الأشخاص. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
exclude_people_locations
string[]

الدول التي يجب ألا يقيم فيها الشخص (ISO 3166-1 alpha-2). مرافق لـ people_locations.

مثال:
company_locations
string[]

موقع مقر الشركة. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.

مثال:
company_exclude_locations
string[]

دول المقر المراد استبعادها (ISO 3166-1 alpha-2). مرافق لـ company_locations؛ إرسال نفس الرمز في كليهما لا يُعيد شيئًا.

مثال:
company_linkedin_urls
string[]

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

مثال:
linkedin_urls
string[]

الرابط الكامل لملف مستخدم على LinkedIn. يبدأ الرابط بـhttp ويحتوي linkedin.com/in/ أو linkedin.com/pub/

مثال:
companies
string<uuid>[]

قائمة من معرّفات فريدة (domain_search_id) تُستخدَم لعمليات البحث عن شركات وأشخاص.

domains
string[]

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

مثال:
company_filters
object

كائن غلاف للمرشحات على مستوى الشركة. تجميع موصى به يفصل بصريًا المفاتيح التي تصفّي الشخص (المستوى الأعلى) عن تلك التي تصفّي الشركة. يقبل نفس مفاتيح مرشحات الشركة في المستوى الأعلى (مثل technologies، verticals، vertical_categories، vertical_sub_categories، categories، keywords، founded_dates، employees، revenues، company_locations، company_exclude_locations، company_places، company_exclude_places، companies، domains، company_linkedin_urls، is_enable_similarity_search، similarity_score، بالإضافة إلى filter_conditions). يُسطِّح المحرك هذا الكائن إلى المستوى الأعلى قبل المعالجة — تفوز مفاتيح المستوى الأعلى عند التعارض. نفس الشكل المُستخدَم في company_filters الخاص بـ Monitor. راجع دليل مطوري Filters Overview للأمثلة.

مثال:
filter_conditions
object[]

تجاوز AND/OR لكل مفتاح للمرشحات في /people/search. الافتراضي OR عند الحذف. راجع دليل مطوري People + Company Filters للحصول على مرجع إعادة تعيين المفاتيح الكامل.

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

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

query
string

بحث باللغة الطبيعية. عند توفيره، يفسّره Pubrio إلى مرشحات الشخص والشركة أدناه (دور الوظيفة، الأقدمية، القسم، الموقع، الصناعة، حجم الشركة، والمزيد). أي مرشحات صريحة تمررها أيضًا لها الأولوية على المرشحات المفسَّرة. اتركه فارغًا للبحث فقط بالمرشحات المهيكلة.

مثال:

"decision makers in marketing"

is_include_similar_people_titles
boolean
افتراضي:true

مفعَّل افتراضيًا. تطابق people_titles أيضًا الصيغ القريبة من كل مسمى (مثلًا، تطابق software engineer أيضًا senior software engineer). تُعيد metadata.filters.people_titles القائمة الكاملة التي جرى البحث بها.

people_title_similarity_score
number<float>

تُستخدم مع is_include_similar_people_titles. تتحكم في مدى قرب المسمى المطلوب مطابقته؛ كلما زاد الرقم، زادت صرامة المطابقة.

مثال:

0.9

technologies
integer[]

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

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

اسم المنتج الموجود في قائمة التقنيات يطابق ذلك المنتج ومنتجاته الخاصة ("Salesforce" يطابق أيضًا Salesforce Desk وSalesforce Service Cloud)، ولا يطابق المنتجات المشابهة؛ أما النص الآخر فيُطابَق حسب التشابه.

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"].

keywords
string[]

قائمة من الكلمات المفتاحية لتصفية الشركات حسب الصلة، أو التخصصات، أو الأوصاف.

مثال:
founded_dates
integer[]

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

مثال:
revenues
integer[]

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

مثال:
company_places
string[]

أسماء أماكن (مدينة، منطقة) تُستخدَم لتصفية النتائج. تقبل أسماء أماكن محلية أو إنجليزية.

مثال:
company_exclude_places
string[]

أسماء أماكن (مدينة، منطقة) مستبعدة من النتائج. تقبل أسماء أماكن محلية أو إنجليزية.

مثال:

الاستجابة

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

metadata
object

سياق الطلب: filters وparameters المُعادة، وكتلة أرصدة profile اختيارية، وignored_fields (مفاتيح جسم الطلب التي تجاهلتها النقطة الطرفية).

data
object | null

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

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