> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # البحث عن الأشخاص > ابحث في قاعدة بيانات Pubrio عن أشخاص يطابقون معايير محددة مثل المسمى الوظيفي، والموقع، والشركة، والأقدمية. ## OpenAPI ````yaml ar-openapi POST /people/search openapi: 3.0.0 info: description: >- تقدّم واجهة Pubrio API معلومات استخباراتية عن توسع السوق — إشارات في الوقت الفعلي تُعلِم عندما تدخل شركة سوقًا جديدة — إلى جانب بيانات الشركات والأشخاص التي تستند إليها. ابحث، وتحقق، وأثرِ الحسابات وجهات التواصل، واشترك في إشارات تحرك مصنَّفة ومؤرَّخة عبر أكثر من 200 سوق. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ar/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ar/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: معلومات ملف مساحة العمل وإحصاءات الاستخدام - name: Enrichment description: إثراء سجلات الأشخاص والشركات ببيانات B2B مفصّلة - name: Lookalike description: إيجاد شركات مشابهة لشركة معينة - name: Search description: البحث عن أشخاص وشركات ووظائف وأخبار وإعلانات بمرشحات - name: Lookup description: البحث عن معلومات مفصّلة لأشخاص وشركات ووظائف وأخبار وإعلانات وتقنيات محددة - name: LinkedIn description: البحث عن بيانات أشخاص وشركات عبر روابط ملفات LinkedIn - name: Redeem description: استبدال أرصدة لفتح بيانات تواصل الأشخاص (فردي ودفعي) - name: Channels description: إدارة قوالب قنوات التواصل (إنشاء، تحديث، حذف، سرد) - name: Monitor description: إنشاء وإدارة Monitors للبيانات بواجهات webhook، وإحصاءات، ومعالجة - name: Filters description: >- استرجاع قيم المرشحات المتاحة لمعاملات البحث (التقنيات، المواقع، القطاعات، إلخ) - name: API Keys description: سرد وفحص سجلات طلبات API وتحليلات الاستخدام لمفاتيح API - name: Insights description: رؤى إشارات مجمَّعة للشركات (الوظائف، الأخبار، الإعلانات). - name: Export description: تصدير بيانات دفعي (مقيَّد بالأرصدة). - name: Expansion description: >- معلومات استخباراتية عن توسع الشركات في السوق: الإشارات، المراحل، الأسواق، والتصدير. externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /people/search: post: tags: - Search summary: البحث عن أشخاص description: >- ابحث في قاعدة بيانات Pubrio عن أشخاص يطابقون معايير محددة مثل المسمى الوظيفي، والموقع، والشركة، والأقدمية. operationId: people_search parameters: [] requestBody: required: true content: application/json: schema: type: object properties: search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' exclude_people_titles: $ref: '#/components/schemas/exclude_people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' exclude_departments: $ref: '#/components/schemas/exclude_departments' department_functions: $ref: '#/components/schemas/functions' exclude_department_functions: $ref: '#/components/schemas/exclude_department_functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' exclude_people_locations: $ref: '#/components/schemas/exclude_people_locations' company_locations: $ref: '#/components/schemas/company_locations' company_exclude_locations: $ref: '#/components/schemas/company_exclude_locations' company_linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' linkedin_urls: $ref: '#/components/schemas/people_linkedin_urls' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' company_filters: $ref: '#/components/schemas/company_filters' filter_conditions: $ref: '#/components/schemas/people_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' query: type: string example: decision makers in marketing description: >- بحث باللغة الطبيعية. عند توفيره، يفسّره Pubrio إلى مرشحات الشخص والشركة أدناه (دور الوظيفة، الأقدمية، القسم، الموقع، الصناعة، حجم الشركة، والمزيد). أي مرشحات صريحة تمررها أيضًا لها الأولوية على المرشحات المفسَّرة. اتركه فارغًا للبحث فقط بالمرشحات المهيكلة. is_include_similar_people_titles: type: boolean description: >- عند التفعيل، تطابق `people_titles` أيضًا المسميات الوثيقة الصلة (مثلًا، تطابق `software engineer` أيضًا `senior software engineer`) بدلًا من المطابقة الدقيقة فقط. people_title_similarity_score: type: number format: float example: 0.9 description: >- تُستخدم مع `is_include_similar_people_titles`. تتحكم في مدى قرب المسمى المطلوب مطابقته؛ كلما زاد الرقم، زادت صرامة المطابقة. responses: '200': description: استجابة ناجحة تحتوي على تفاصيل البحث عن الأشخاص. content: application/json: schema: type: object properties: metadata: type: object description: >- سياق الطلب: `filters` و`parameters` المُعادة، وكتلة أرصدة `profile` اختيارية، و`ignored_fields` (مفاتيح جسم الطلب التي تجاهلتها النقطة الطرفية). data: $ref: '#/components/schemas/data' example: metadata: filters: management_levels: - c_suite profile: null data: pagination: page: 1 per_page: 25 total_entries: 199616132 total_pages: 100 total_display_pages: 100 is_timeout: false peoples: - people_search_id: 134591fb-f0fa-41ba-9c8c-f1eb8aab8946 name: Doug McMillon first_name: Doug last_name: McMillon title: President & CEO seniority: c_suite functions: null headline: President & CEO at Walmart Inc. tagline: null introduction: null description: null departments: - c_suite subdepartments: - executive keywords: null employment_history: - title: President & CEO current: true end_date: null start_date: '2014-02-01' company_name: Walmart - title: President & CEO, Walmart International current: false end_date: '2014-01-01' start_date: '2009-02-01' company_name: Walmart - title: President & CEO current: false end_date: '2009-01-01' start_date: '2005-08-01' company_name: Sam's Club country: United States country_code: US location: United States state: Arkansas city: Bentonville wantedly_name: null rocketpunch_name: null contacts: null contact_types: [] emails: null phones: null facebook_url: null github_url: null twitter_url: null linkedin_url: http://www.linkedin.com/in/dougmcmillon wantedly_url: null rocketpunch_url: null saved_lists: null sequences: null social_metadata: {} company: company_name: Walmart company_url: http://walmart.com is_company_url_active: true domain: walmart.com domain_id: 26067151 domain_ids: - 757023267 - 368242703 - 26067151 domain_search_id: 2a0d6cd7-cc10-44d6-94ec-41fd528a11b6 founded_year: 1962 country: United States country_code: US location: United States phones: null emails: [] contacts: [] wantedly_name: null rocketpunch_name: null tiktok_name: null company_size_printed: 466,000 company_size: 466000 industry: Retail specialties: - Retail - E-commerce logo_url: >- https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg linkedin_url: http://www.linkedin.com/company/walmart facebook_url: http://facebook.com/walmart twitter_url: https://twitter.com/walmart crunchbase_url: null instagram_url: http://instagram.com/walmart youtube_url: http://youtube.com/user/walmart x_url: null github_url: null tiktok_url: null wantedly_url: null rocketpunch_url: null social_metadata: {} - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: search_term: type: string example: pubrio description: سلسلة من الكلمات نريد تصفية النتائج بها. people_name: type: string example: king description: صفِّ نتائج البحث لتشمل اسم شخص محدد. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- المسميات الوظيفية المرتبطة بالأفراد الذين تهدف إلى تحديدهم. ستشمل النتائج أيضًا مسميات وظيفية تحتوي مصطلحات مشابهة، حتى لو لم تطابق تمامًا. مثلًا، البحث عن `software engineer` قد يُظهر نتائج لأفراد بمسمى `senior software engineer`. exclude_people_titles: type: array items: type: string example: - intern - assistant description: >- المسميات الوظيفية المراد استبعادها. نفس المطابقة على مستوى الكلمة كما في `people_titles`، بحيث تزيل `["senior"]` كل مسمى يحتوي تلك الكلمة. تُطبَّق بعد `people_titles`. peoples: type: array items: type: string format: uuid description: >- قائمة من معرّفات فريدة (people_search_id) تُستخدَم لعمليات البحث عن أشخاص. management_levels: type: array items: type: string enum: - c_suite - director - entry - founder - head - intern - manager - owner - partner - senior - vp example: - c_suite - vp description: >- المستوى الوظيفي للشخص. الاسم القياسي للمستوى القيادي العليا هو `c_suite`، لا `c_level`. تُهمَل الأسماء القياسية غير المعروفة عند وجود مرشحات أشخاص أخرى، وتفشل برمز `40037` عندما تكون هذا هو الوحيد. القائمة الكاملة من نقطة `management level` تحت تبويب Filters. departments: type: array items: type: string example: - master_human_resources description: |- يمكن أن يبحث حقل القسم عن أشخاص في مجالات خبرة محددة. راجع نقاط `department` تحت تبويب Filters لمزيد من المعلومات. exclude_departments: type: array items: type: string example: - master_human_resources description: >- الأسماء القياسية للأقسام المراد استبعادها. نفس مفردات `departments`. يُبقى على الأشخاص الذين لا قسم مسجَّل لهم. functions: type: array items: type: string example: - human_resources description: >- يمكن أن يحدد حقل مرشح الوظائف الأساسية أدوارًا أو مجالات خبرة معينة عند البحث عن أشخاص. راجع نقاط `department functions` تحت تبويب Filters لمزيد من المعلومات. exclude_department_functions: type: array items: type: string example: - software_development description: >- الأسماء القياسية للوظائف الأساسية المراد استبعادها. نفس مفردات `department_functions`. يُبقى على الأشخاص الذين لا وظيفة أساسية مسجَّلة لهم. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- نطاق عدد الموظفين العاملين في الشركة. يتيح لك هذا إيجاد شركات بناءً على عدد الموظفين. يمكنك إضافة نطاقات متعددة لتوسيع نتائج بحثك. راجع نقاط `company size` تحت تبويب Filters لمزيد من المعلومات. people_locations: type: array items: type: string example: - US - SG - CN description: >- الموقع الذي يقيم فيه الأشخاص. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. exclude_people_locations: type: array items: type: string example: - US description: >- الدول التي **يجب ألا** يقيم فيها الشخص (ISO 3166-1 alpha-2). مرافق لـ `people_locations`. company_locations: type: array items: type: string example: - US - SG - CN description: >- موقع مقر الشركة. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. company_exclude_locations: type: array items: type: string example: - CN description: >- دول المقر المراد استبعادها (ISO 3166-1 alpha-2). مرافق لـ `company_locations`؛ إرسال نفس الرمز في كليهما لا يُعيد شيئًا. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- الرابط الكامل لملف شركة على LinkedIn. يبدأ الرابط بـ`http` ويحتوي `linkedin.com/company/` people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- الرابط الكامل لملف مستخدم على LinkedIn. يبدأ الرابط بـ`http` ويحتوي `linkedin.com/in/` أو `linkedin.com/pub/` companies: type: array items: type: string format: uuid description: >- قائمة من معرّفات فريدة (domain_search_id) تُستخدَم لعمليات البحث عن شركات وأشخاص. domains: type: array items: type: string example: - pubrio.com description: >- قائمة نطاقات شركات تُستخدَم لعمليات البحث عن شركات وأشخاص. إن استلمنا رابطًا مثل `www.pubrio.com` أو `https://docs.pubrio.com/`، سيحوّله النظام إلى `pubrio.com` للمعالجة. company_filters: type: object description: >- كائن غلاف للمرشحات على مستوى الشركة. تجميع موصى به يفصل بصريًا المفاتيح التي تصفّي *الشخص* (المستوى الأعلى) عن تلك التي تصفّي *الشركة*. يقبل نفس مفاتيح مرشحات الشركة في المستوى الأعلى (مثل `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 للأمثلة. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and people_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - places - exclude_places - social_media example: technologies description: >- مفتاح المرشح الذي يحدد الخاصية التي يُطبَّق عليها العامل. تشير المفاتيح إلى أسماء مرشحات الشركة الموحَّدة (استخدم `places`، لا `company_places`). operator: type: string enum: - or - and example: and description: >- العامل المنطقي المراد تطبيقه. استخدم 'or' لمطابقة أي من القيم المحددة، أو 'and' لاشتراط كل القيم المحددة. description: >- تجاوز AND/OR لكل مفتاح للمرشحات في /people/search. الافتراضي OR عند الحذف. راجع دليل مطوري People + Company Filters للحصول على مرجع إعادة تعيين المفاتيح الكامل. is_enable_similarity_search: type: boolean description: >- عند التفعيل، يمكن ملء المرشحات المذكورة أعلاه التي تدعم بحث التشابه بنص حر لمعرّفات محددة. similarity_score: type: number format: float example: 0.7 description: >- يُستخدَم مع `is_enable_similarity_search`. يُستخدَم هذا الرقم لتحليل ما إذا كان اسم قياسي محدد (مثل قطاع صناعي، تقنية) مشابهًا لمدخل المستخدم، وكلما زاد الرقم، زادت الصرامة. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- السجلات لكل صفحة. القيمة الافتراضية 25، وهي أيضًا السقف في معظم الخطط — الحد هو `max_search_per_page` الخاص باشتراكك، الذي تُعيده [Profile](/ar/api-reference/endpoint/profile/profile). تجاوزه يُعيد **HTTP 416** برمز `41676` (أو `41613` في بحث الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة. page: type: integer example: 1 default: 1 description: >- رقم الصفحة، بدءًا من 1. السقف هو `max_search_page` الخاص باشتراكك (`max_company_search_page` لبحث الشركات)، الذي تُعيده [Profile](/ar/api-reference/endpoint/profile/profile). تجاوزه يُعيد **HTTP 416**. data: type: object nullable: true description: تعتمد معلومات الاستجابة على النقطة الطرفية المحددة. responses: general_error: description: >- طلب غير صحيح. كان الطلب مُصاغًا بشكل خاطئ أو يحتوي معاملات غير صالحة. تحقق من رمز الخطأ والرسالة للتفاصيل. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- تم تجاوز حد المعدل. نُفِّذت طلبات كثيرة جدًا خلال فترة زمنية معينة. أعِد المحاولة بعد إعادة ضبط نافذة حد المعدل. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- خطأ خادم داخلي. حدث خطأ غير متوقع في الخادم. تواصل مع الدعم إن استمر الخطأ. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات والعمليات المقابلة. يمكنك إنشاءه عبر قسم [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````