> ## 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/rankings 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/rankings: post: tags: - Expansion summary: تصنيفات التوسع description: >- قائمة مرتبة خفيفة الوزن من أزواج الشركة/السوق حسب درجة التوسع — مناسبة لعرض الخرائط أو الخرائط الحرارية. operationId: expansions_company_rankings requestBody: required: true content: application/json: schema: type: object properties: froms: $ref: '#/components/schemas/expansion_froms' tos: $ref: '#/components/schemas/expansion_tos' exclude_froms: $ref: '#/components/schemas/expansion_exclude_froms' exclude_tos: $ref: '#/components/schemas/expansion_exclude_tos' stages: allOf: - $ref: '#/components/schemas/expansion_stages' description: >- القيم حساسة لحالة الأحرف و**لا تُتحقَّق منها**. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في `stages` و`freshness` و`scopes` و`momentum` يُسقَط المرشح بأكمله وتحصل على نتائج *غير مصفّاة*، بينما في `signal_types` و`signal_strengths` يُطبَّق المرشح ولا يطابق *شيئًا*. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من [مرجع التوسع](/ar/api-reference/endpoint/expansions/types) وقارن `data.pagination.total_entries` مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة. signal_types: allOf: - $ref: '#/components/schemas/expansion_signal_type_slugs' description: >- القيم حساسة لحالة الأحرف و**لا تُتحقَّق منها**. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في `stages` و`freshness` و`scopes` و`momentum` يُسقَط المرشح بأكمله وتحصل على نتائج *غير مصفّاة*، بينما في `signal_types` و`signal_strengths` يُطبَّق المرشح ولا يطابق *شيئًا*. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من [مرجع التوسع](/ar/api-reference/endpoint/expansions/types) وقارن `data.pagination.total_entries` مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة. signal_strengths: allOf: - $ref: '#/components/schemas/signal_strengths' description: >- القيم حساسة لحالة الأحرف و**لا تُتحقَّق منها**. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في `stages` و`freshness` و`scopes` و`momentum` يُسقَط المرشح بأكمله وتحصل على نتائج *غير مصفّاة*، بينما في `signal_types` و`signal_strengths` يُطبَّق المرشح ولا يطابق *شيئًا*. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من [مرجع التوسع](/ar/api-reference/endpoint/expansions/types) وقارن `data.pagination.total_entries` مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة. min_signal_count: type: integer example: 3 description: >- الحد الأدنى لعدد إشارات التوسع التي يجب أن تملكها شركة ضمن النافذة — "نشطة جدًا / بصمة ثقيلة". only_contraction: $ref: '#/components/schemas/only_contraction' domain_search_ids: allOf: - $ref: '#/components/schemas/expansion_domain_search_ids' description: الشركات المراد التحديد بها، حسب `domain_search_id`. verticals: $ref: '#/components/schemas/verticals' vertical_categories: $ref: '#/components/schemas/vertical_categories' vertical_sub_categories: $ref: '#/components/schemas/vertical_sub_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' companies: $ref: '#/components/schemas/expansion_companies' 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' advertisement_target_locations: $ref: '#/components/schemas/advertisement_target_locations' advertisement_exclude_target_locations: $ref: '#/components/schemas/advertisement_exclude_target_locations' advertisement_search_terms: $ref: '#/components/schemas/advertisement_search_terms' advertisement_start_dates: $ref: '#/components/schemas/advertisement_start_dates' advertisement_end_dates: $ref: '#/components/schemas/advertisement_end_dates' news_categories: $ref: '#/components/schemas/news_categories' news_published_dates: $ref: '#/components/schemas/published_dates' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' select_size: $ref: '#/components/schemas/expansion_select_size' 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 is_enable_similarity_search: type: boolean description: >- فعّل المطابقة بالنص الحر لـ `verticals` و`vertical_categories` و`vertical_sub_categories` و`technologies`؛ تُسقَط تلك المرشحات ما لم تكن هذه بقيمة `true`. example: true responses: '200': description: علامات مرتبة لأزواج الشركة/السوق. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: حاوية النتائج. properties: markers: type: array description: صف واحد لكل زوج شركة/سوق، مرتب حسب درجة التوسع. items: type: object properties: domain_search_id: type: string description: معرّف شركة في Pubrio. country_code: type: string description: السوق المستهدفة، ISO 3166-1 alpha-2. stage_slug: type: string description: مرحلة التوسع الحالية. expansion_score: type: integer description: درجة التوسع لزوج الشركة/السوق هذا. freshness: type: string description: مدى حداثة الإشارات الأساسية. direction: type: string description: مسار المرحلة. example: metadata: filters: froms: - CN tos: - GB select_size: 250 count: 1 data: markers: - domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US stage_slug: expanding expansion_score: 0.721 freshness: fresh direction: advancing '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_froms: type: array items: type: string example: - US - GB description: >- أسواق المنشأ (ISO 3166-1 alpha-2). من أين تتوسع شركة — دولها الأصلية/مقرها. استخدمها وحدها لإيجاد شركات تنمو خارج هذه الأسواق؛ اجمعها مع `tos` لممر محدد من→إلى. expansion_tos: type: array items: type: string example: - US - GB description: >- الأسواق المستهدفة (ISO 3166-1 alpha-2). إلى أين تتوسع شركة. استخدمها وحدها لإيجاد كل شركة تدخل هذه الأسواق؛ اجمعها مع `froms` لممر محدد من→إلى. expansion_exclude_froms: type: array items: type: string example: - US - GB description: أسواق المنشأ المستبعدة (ISO 3166-1 alpha-2). expansion_exclude_tos: type: array items: type: string example: - US - GB description: الأسواق المستهدفة المستبعدة (ISO 3166-1 alpha-2). expansion_stages: type: array items: type: string enum: - exploring - committing - expanding - scaling example: - committing - expanding description: >- التحديد لمرحلة توسع واحدة أو أكثر. راجع قاعدة معرفة إشارات التوسع لتعريفات المراحل. expansion_signal_type_slugs: type: array items: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: - EXEC - HIRE description: >- التحديد لأنواع إشارات محددة. راجع كتالوج أنواع الإشارات في قاعدة المعرفة للتعريفات والفئات (`DNS` و`INFRA` إشارات من الفئة المتميزة Premier). signal_strengths: type: array items: type: string enum: - low - medium - high - very_high example: - high description: >- التصفية حسب فئة ثقة الأدلة: `low`، `medium`، أو `high`. لاحظ أن هذا مختلف عن `signal_strength_slug` الخاص بكل إشارة المُعاد في سجلات الإشارة (والذي يمتد من `low` إلى `very_high`)؛ أي قيمة أخرى هنا لا تطابق شيئًا. only_contraction: type: boolean example: false description: عند true، أعِد فقط التوسعات الموسومة بالانكماش (الشركات المتقلصة). expansion_domain_search_ids: type: array items: type: string example: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c description: معرّفات الشركات (domain_search_id UUID) المراد تضمينها. 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"]`. 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: >- قائمة من الكلمات المفتاحية لتصفية الشركات حسب الصلة، أو التخصصات، أو الأوصاف. 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`، أو نطاق الشركة، أو رابط ملف شركة على وسائل التواصل الاجتماعي. تُحل النطاقات والروابط إلى أفضل شركة مطابقة مرتبة. locations: type: array items: type: string example: - US - SG - CN description: >- يُستخدَم ISO 3166-1 alpha-2 (cca2) لتصفية المواقع. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. 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`. advertisement_target_locations: allOf: - $ref: '#/components/schemas/target_locations' description: المواقع الجغرافية المستهدفة للإعلانات. advertisement_exclude_target_locations: allOf: - $ref: '#/components/schemas/exclude_target_locations' description: المواقع الجغرافية المستبعدة من استهداف الإعلانات. advertisement_search_terms: type: array items: type: string example: - asus 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: نطاق تاريخ النهاية لتصفية الإعلانات. 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: >- نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك. expansion_is_include_established: type: boolean example: false description: >- أدرِج مرحلة `established` (المشغّلون العريقون دون إشارات توسع نشطة). الافتراضي false. expansion_select_size: type: integer example: 50 description: الحد الأقصى لعدد السجلات المُعادة. محدود حسب خطتك. exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: >- يُستخدَم ISO 3166-1 alpha-2 (cca2) لاستبعاد المواقع التي لا يلزم إعادتها. راجع نقاط `location` تحت تبويب Filters لمزيد من المعلومات. 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 ````