> ## 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. # البحث عن شركات مشابهة > اعثر على شركات مشابهة لشركة مرجعية. مرّر معرّفًا فرديًا واحدًا بالضبط (`domain_search_id`، `domain`، `linkedin_url` أو `*_url` آخر)؛ تحمل الصفوف `similarity_score` وتُرتَّب حسبها، الأعلى أولًا. ## OpenAPI ````yaml ar-openapi POST /companies/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: /companies/search/similar: post: tags: - Lookalike summary: البحث عن شركات مماثلة description: >- اعثر على شركات مشابهة لشركة مرجعية. مرّر معرّفًا فرديًا واحدًا بالضبط (`domain_search_id`، `domain`، `linkedin_url` أو `*_url` آخر)؛ تحمل الصفوف `similarity_score` وتُرتَّب حسبها، الأعلى أولًا. operationId: companies_search_similar parameters: [] requestBody: required: true content: application/json: schema: type: object properties: domain_search_id: type: string description: معرّف شركة في Pubrio. domain: type: string description: النطاق الأساسي للشركة، مثل `stripe.com`. example: stripe.com linkedin_url: type: string description: رابط شركة على LinkedIn. tiktok_url: type: string description: رابط ملف الشركة على TikTok. wantedly_url: type: string description: رابط ملف الشركة على Wantedly. tw104_url: type: string description: رابط ملف الشركة على 104 (تايوان). rocketpunch_url: type: string description: رابط ملف الشركة على RocketPunch. remember_url: type: string description: رابط ملف الشركة على Remember. youtrust_url: type: string description: رابط ملف الشركة على YOUTRUST. company_name: $ref: '#/components/schemas/company_name' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' locations: $ref: '#/components/schemas/locations' exclude_locations: $ref: '#/components/schemas/exclude_locations' places: $ref: '#/components/schemas/places' exclude_places: $ref: '#/components/schemas/exclude_places' job_locations: $ref: '#/components/schemas/locations' job_exclude_locations: $ref: '#/components/schemas/job_exclude_locations' job_posted_dates: $ref: '#/components/schemas/posted_dates' job_titles: $ref: '#/components/schemas/people_titles' verticals: $ref: '#/components/schemas/verticals' vertical_categories: $ref: '#/components/schemas/vertical_categories' vertical_sub_categories: $ref: '#/components/schemas/vertical_sub_categories' categories: $ref: '#/components/schemas/categories' technologies: $ref: '#/components/schemas/technologies' employees: $ref: '#/components/schemas/employees' revenues: $ref: '#/components/schemas/revenues' founded_dates: $ref: '#/components/schemas/founded_dates' keywords: $ref: '#/components/schemas/keywords' news_categories: $ref: '#/components/schemas/news_categories' news_published_dates: $ref: '#/components/schemas/published_dates' advertisement_search_terms: $ref: '#/components/schemas/advertisement_search_terms' advertisement_target_locations: $ref: '#/components/schemas/advertisement_target_locations' advertisement_exclude_target_locations: $ref: '#/components/schemas/advertisement_exclude_target_locations' advertisement_start_dates: $ref: '#/components/schemas/advertisement_start_dates' advertisement_end_dates: $ref: '#/components/schemas/advertisement_end_dates' filter_conditions: $ref: '#/components/schemas/company_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' exclude_fields: $ref: '#/components/schemas/exclude_fields' is_parameter_metadata_available: $ref: '#/components/schemas/is_parameter_metadata_available' is_profile_metadata_available: $ref: '#/components/schemas/is_profile_metadata_available' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' company_filters: $ref: '#/components/schemas/company_filters' anyOf: - title: domain_search_id required: - domain_search_id - title: domain required: - domain - title: linkedin_url required: - linkedin_url - title: tiktok_url required: - tiktok_url - title: wantedly_url required: - wantedly_url - title: tw104_url required: - tw104_url - title: rocketpunch_url required: - rocketpunch_url - title: remember_url required: - remember_url - title: youtrust_url required: - youtrust_url responses: '200': description: استجابة ناجحة تحتوي على تفاصيل البحث عن الشركات. content: application/json: schema: type: object properties: metadata: type: object description: >- سياق الطلب. يحمل `filters` و`parameters` المُعادة، وكتلة `profile` تحوي `credit` و`topup_credit` و`total_credit_cost` — وهي المحاسبة الوحيدة للأرصدة لكل استدعاء التي تُعيدها الواجهة. data: type: array description: >- الشركات المشابهة، مرتبة حسب التشابه. لاحظ أن هذه النقطة الطرفية تُعيد مصفوفة مجردة — بخلاف نقاط البحث الأخرى، لا يوجد غلاف `pagination` داخل `data`. items: type: object example: data: pagination: page: 1 per_page: 25 total_entries: 45234700 total_pages: 1809388 companies: - logo_url: >- https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg company_name: Twitter emails: - ... phones: - ... contacts: - ... founded_year: 2006 specialties: - Software Development industry: Software Development domain: twitter.com domain_search_id: 61a73da7-2efc-41a5-a252-a8a8df29925a domain_id: 224475931 linkedin_company_id: 44005587 linkedin_name: twitter is_company_url_active: true domain_ids: - 224475931 - 1758889566 - 368242865 company_keywords: - realtime information - social commerce - online shopping - classifieds - craigslist killers - e-commerce - killers - consumer internet - internet - information technology - edp services - technology - software development - microblogging - social networking - public conversation - user engagement - content sharing - advertising solutions - monetization - community building - digital wallet - ai integration - user safety company_size: 1500 youtube_url: null crunchbase_url: null linkedin_url: http://www.linkedin.com/company/twitter instagram_url: null facebook_url: http://facebook.com/twitterinc twitter_url: https://twitter.com/x github_url: null x_url: null location: United States company_ranking: null company_url: http://twitter.com saved_lists: null company_size_printed: 1,500 similarity_score: 0.87 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: company_name: type: string example: pubrio description: |- صفِّ نتائج البحث لتشمل اسم شركة محدد. إن لم تطابق القيمة التي تدخلها لهذا المعامل اسم شركة، لن تظهر الشركة في نتائج البحث، حتى إن طابقت معاملات أخرى. تُقبل المطابقات الجزئية. 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_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- الرابط الكامل لملف شركة على LinkedIn. يبدأ الرابط بـ`http` ويحتوي `linkedin.com/company/` locations: type: array items: type: string example: - US - SG - CN description: >- يُستخدَم ISO 3166-1 alpha-2 (cca2) لتصفية المواقع. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: >- يُستخدَم ISO 3166-1 alpha-2 (cca2) لاستبعاد المواقع التي لا يلزم إعادتها. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. places: type: array items: type: string example: - Tokyo description: >- أسماء أماكن (مدينة، منطقة) تُستخدَم لتصفية النتائج. تقبل أسماء أماكن محلية أو إنجليزية. exclude_places: type: array items: type: string example: - Tokyo description: >- أسماء أماكن (مدينة، منطقة) مستبعدة من النتائج. تقبل أسماء أماكن محلية أو إنجليزية. job_exclude_locations: allOf: - $ref: '#/components/schemas/exclude_locations' description: المواقع الجغرافية المستبعدة من نتائج إعلانات الوظائف. posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- المسميات الوظيفية المرتبطة بالأفراد الذين تهدف إلى تحديدهم. ستشمل النتائج أيضًا مسميات وظيفية تحتوي مصطلحات مشابهة، حتى لو لم تطابق تمامًا. مثلًا، البحث عن `software engineer` قد يُظهر نتائج لأفراد بمسمى `senior software engineer`. verticals: type: array items: type: integer description: >- قائمة من `vertical_id` تُستخدَم للبحث عن شركات في قطاع أو صناعة محددة. لإيجاد المعرّف، استدعِ نقطة `vertical` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["AI"]`. vertical_categories: type: array items: type: integer description: >- قائمة من `vertical_category_id` تُستخدَم للبحث عن شركات في فئة قطاع محددة. لإيجاد المعرّف، استدعِ نقطة `vertical category` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["Information Technology"]`. vertical_sub_categories: type: array items: type: integer description: >- قائمة من `vertical_sub_category_id` تُستخدَم للبحث عن شركات في فئة فرعية محددة لقطاع. لإيجاد المعرّف، استدعِ نقطة `vertical sub category` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["Software"]`. categories: type: array items: type: integer description: >- قائمة من `category_id` تُستخدَم للبحث عن فئات محددة من التقنيات التي تستخدمها الشركات. لإيجاد المعرّف، استدعِ نقطة `category` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["CDN"]`. technologies: type: array items: type: integer description: >- قائمة من `tag_id` تُستخدَم للبحث عن تقنيات محددة تستخدمها الشركات. لإيجاد المعرّف، استدعِ نقطة `technology` تحت تبويب Filters. يدعم هذا المرشح `is_enable_similarity_search`، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل `["Shopify"]`. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- نطاق عدد الموظفين العاملين في الشركة. يتيح لك هذا إيجاد شركات بناءً على عدد الموظفين. يمكنك إضافة نطاقات متعددة لتوسيع نتائج بحثك. راجع نقاط `company size` تحت تبويب Filters لمزيد من المعلومات. revenues: type: array items: type: integer example: - 0 - 100000 description: الحد الأدنى والأقصى لنطاق إيرادات الشركة. founded_dates: type: array items: type: integer example: - 2018 - 2024 description: نطاق سنوات تأسيس الشركة. القيمة القصوى للتأسيس هي السنة الحالية. keywords: type: array items: type: string example: - ecommerce - ai - fintech description: >- قائمة من الكلمات المفتاحية لتصفية الشركات حسب الصلة، أو التخصصات، أو الأوصاف. news_categories: type: array items: type: string example: - launches description: >- قائمة من `category slugs` للبحث عن فئات أخبار محددة. لإيجاد اسم قياسي، استدعِ نقطة `news categories` تحت تبويب Filters. published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك. advertisement_search_terms: type: array items: type: string example: - asus description: كلمات مفتاحية تُستخدَم للبحث ضمن محتوى الإعلان أو عناوينه. advertisement_target_locations: allOf: - $ref: '#/components/schemas/target_locations' description: المواقع الجغرافية المستهدفة للإعلانات. advertisement_exclude_target_locations: allOf: - $ref: '#/components/schemas/exclude_target_locations' description: المواقع الجغرافية المستبعدة من استهداف الإعلانات. advertisement_start_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: نطاق تاريخ البداية لتصفية الإعلانات. advertisement_end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: نطاق تاريخ النهاية لتصفية الإعلانات. company_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - advertisement_target_locations - advertisement_exclude_target_locations - advertisement_search_terms - places - exclude_places - job_exclude_locations example: keywords description: مفتاح المرشح الذي يحدد الخاصية التي يُطبَّق عليها العامل. operator: type: string enum: - or - and example: or description: >- العامل المنطقي المراد تطبيقه. استخدم 'or' لمطابقة أي من القيم المحددة، أو 'and' لاشتراط كل القيم المحددة. description: >- خيارات تصفية متقدمة لعمليات البحث عن الشركات. حدّد شروطًا تجمع بين مفاتيح وعوامل منطقية لتحسين نتائج البحث. is_enable_similarity_search: type: boolean description: >- عند التفعيل، يمكن ملء المرشحات المذكورة أعلاه التي تدعم بحث التشابه بنص حر لمعرّفات محددة. similarity_score: type: number format: float example: 0.7 description: >- يُستخدَم مع `is_enable_similarity_search`. يُستخدَم هذا الرقم لتحليل ما إذا كان اسم قياسي محدد (مثل قطاع صناعي، تقنية) مشابهًا لمدخل المستخدم، وكلما زاد الرقم، زادت الصرامة. exclude_fields: type: array items: type: string example: - emails - phones - contacts description: قائمة الحقول المستبعدة من حمولة الاستجابة. is_parameter_metadata_available: type: boolean description: يشير إلى ما إذا كانت بيانات المعامل الوصفية متاحة للطلب. is_profile_metadata_available: type: boolean description: يشير إلى ما إذا كانت بيانات الملف الشخصي الوصفية متاحة للطلب. 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 target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- صفِّ الإعلانات لتشمل تلك المستهدِفة مواقع محددة حسب رمز الدولة. استخدم هذا لإيجاد إعلانات تُعرض في دول محددة. يجمع مع `filter_conditions` باستخدام عامل OR — يجب أن يستهدف الإعلان موقعًا واحدًا على الأقل من المواقع المحددة. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- صفِّ الإعلانات لاستبعاد تلك المستهدِفة مواقع محددة حسب رمز الدولة. استخدم هذا لاستبعاد إعلانات تُعرض في دول محددة. عند تحديدها في `filter_conditions` بعامل 'or'، يجب ألا يستهدف الإعلان أيًا من المواقع المستبعدة. 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 ````