> ## 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. # مقارنة توسعات الشركات > قارن بصمة التوسع لعدة شركات جنبًا إلى جنب، مع نظراء قابلين للمقارنة اختياريين لشركة مستهدفة. ## OpenAPI ````yaml ar-openapi POST /expansions/companies/compare 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: /expansions/companies/compare: post: tags: - Expansion summary: مقارنة توسعات الشركات description: >- قارن بصمة التوسع لعدة شركات جنبًا إلى جنب، مع نظراء قابلين للمقارنة اختياريين لشركة مستهدفة. operationId: expansions_company_compare requestBody: required: true content: application/json: schema: type: object properties: companies: $ref: '#/components/schemas/expansion_companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- نطاق تاريخ ISO `[من, إلى]` لنافذة الإشارة/الانتقال. له الأولوية على `window_days` عند توفير كليهما. window_days: $ref: '#/components/schemas/window_days' seed_target: type: string example: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c description: >- الشركة ضمن `companies` المراد معاملتها كهدف مرجعي. تُرتَّب البقية حسب حجم الإشارة والثقة، وتُعاد أفضل النظراء في `metadata.seeded_peers`. يختار من القائمة التي ترسلها؛ ولا يجد شركات جديدة. is_include_established: $ref: '#/components/schemas/expansion_is_include_established' is_include_metadata: type: boolean description: >- أعِد حمولة التفاصيل الكاملة. حركة مرور مفتاح API مختصرة افتراضيًا: تُحذَف كتلة `model`، وأرقام الثقة (`stage.confidence` في تفاصيل توسع الشركة، و`confidence_score` في `other_markets[]` وفي `markers[]` الخاصة بالتصنيفات)، وحقول `established_min` / `share_of_detected` / `has_known_office` ما لم تكن هذه بقيمة `true`. example: true responses: '200': description: مقارنة لكل شركة، مفهرسة بـ domain_search_id. content: application/json: schema: type: object properties: metadata: type: object properties: seeded_peers: type: array items: type: string description: >- النظراء المختارون لـ `seed_target`، الأفضل مطابقة أولًا. فارغة عند حذف `seed_target`. peer_cap: type: integer nullable: true description: >- الحد الأقصى للنظراء الذين قد تقيسهم خطتك، أو `null` عندما يكون غير محدود. peers_available: type: integer description: >- عدد النظراء الذين كانت لديهم إشارات ضمن النافذة، قبل تطبيق `peer_cap`. data: type: object properties: companies: type: array items: type: object description: إدخال واحد لكل شركة تمت مقارنتها، بترتيب الطلب. example: metadata: seeded_peers: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c data: companies: - domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c home_country_code: SG firmographics: company_name: Example Corp country_code: SG company_size: 350 founded_year: 2015 industry: Software Development publicly_traded_symbol: null estimated_revenue: 25000000 markets_summary: - country_code: US stage_slug: committing signal_count: 12 distinct_type_count: 4 first_signal_at: '2026-04-02T08:00:00.000Z' latest_signal_at: '2026-06-28T10:15:22.000Z' last_transition_at: '2026-06-25T14:30:00.000Z' expansion_score: 0.685 signals: - signal_type_slug: EXEC signal_subtype_slug: country_manager event_date: '2026-06-20T14:00:00.000Z' display_label: Hired Regional VP for North America '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_companies: type: array items: type: string example: - stripe.com - https://www.linkedin.com/company/airbnb - b7d92a56-31f8-4c0b-ae43-19c8e5f24b70 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/` window_days: type: integer example: 90 description: >- اختياري. حجم النافذة المتحركة بالأيام. يُستخدَم عندما لا يُوفَّر نطاق `transitioned_dates` صريح؛ إن حُذف كلاهما، تُستخدَم نافذة افتراضية. expansion_is_include_established: type: boolean example: false description: >- أدرِج مرحلة `established` (المشغّلون العريقون دون إشارات توسع نشطة). الافتراضي false. 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 ````