> ## 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. # البحث عن أشخاص مشابهين > اعثر على أشخاص مشابهين لشخص مرجعي. مرّر مرجعًا واحدًا (`people_search_id`، `linkedin_url`، `linkedin_urls`، `peoples` أو `people_titles`)؛ تحمل الصفوف `similarity_score` وتُرتَّب حسبها، الأعلى أولًا. ## OpenAPI ````yaml ar-openapi POST /people/search/similar 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/similar: post: tags: - Lookalike summary: البحث عن أشخاص مشابهين description: >- اعثر على أشخاص مشابهين لشخص مرجعي. مرّر مرجعًا واحدًا (`people_search_id`، `linkedin_url`، `linkedin_urls`، `peoples` أو `people_titles`)؛ تحمل الصفوف `similarity_score` وتُرتَّب حسبها، الأعلى أولًا. operationId: people_search_similar parameters: [] requestBody: required: true content: application/json: schema: type: object properties: people_search_id: type: string description: معرّف شخص في Pubrio يُستخدم كمرجع. linkedin_url: type: string description: رابط ملف LinkedIn واحد يُستخدم كمرجع. identifier: type: string description: >- سلسلة نصية حرة كمرجع (اسم، مسمى وظيفي، أو رابط ملف) لبدء بحث التشابه. search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' department_functions: $ref: '#/components/schemas/functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' company_locations: $ref: '#/components/schemas/company_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' 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' company_filters: $ref: '#/components/schemas/company_filters' anyOf: - title: peoples required: - peoples - title: people_search_id required: - people_search_id - title: people_titles required: - people_titles - title: linkedin_url required: - linkedin_url - title: linkedin_urls required: - linkedin_urls - title: identifier required: - identifier responses: '200': description: استجابة ناجحة تحتوي على تفاصيل البحث عن الأشخاص. content: application/json: schema: type: object properties: metadata: type: object description: >- سياق الطلب — `filters` و`parameters` المُعادة، بالإضافة إلى كتلة `profile` تحوي `credit` و`topup_credit` و`total_credit_cost` عند طلب محاسبة الأرصدة. 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`. 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 لمزيد من المعلومات. functions: type: array items: type: string example: - human_resources description: >- يمكن أن يحدد حقل مرشح الوظائف الأساسية أدوارًا أو مجالات خبرة معينة عند البحث عن أشخاص. راجع نقاط `department functions` تحت تبويب Filters لمزيد من المعلومات. 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 لمزيد من المعلومات. company_locations: type: array items: type: string example: - US - SG - CN description: >- موقع مقر الشركة. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. 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` للمعالجة. 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**. 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 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 ````