> ## 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/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: /expansions/search: post: tags: - Expansion summary: البحث في التوسع description: >- اعثر على شركات تتوسع إلى سوق واحدة أو أكثر باستخدام مرشحات وصفية للشركة والإشارة أو استعلام بلغة طبيعية، مع تفسيرات مطابقة اختيارية بالذكاء الاصطناعي مستندة إلى الإشارات الحقيقية لكل شركة. operationId: expansions_search 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` مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة. momentum: allOf: - $ref: '#/components/schemas/expansion_momentum' description: >- مسار تحرك الشركة في السوق. `advancing` يعني كسب أرض، و`steady` يعني الثبات، و`pulling_back` يغطي التراجع والانكماش. **لا** تستخدم القيم من `directions` في [مرجع التوسع](/ar/api-reference/endpoint/expansions/types) هنا. تلك (`advancing`، `steady`، `retreating`، `new`) هي قيم *الاستجابة* التي تحصل عليها في `stage.direction`؛ فقط الثلاث المذكورة أعلاه مقبولة *كمرشح*. إرسال `retreating` أو `new` يعطّل المرشح بصمت ويُعيد نتائج غير مصفّاة. freshness: allOf: - $ref: '#/components/schemas/expansion_freshness' description: >- القيم حساسة لحالة الأحرف و**لا تُتحقَّق منها**. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في `stages` و`freshness` و`scopes` و`momentum` يُسقَط المرشح بأكمله وتحصل على نتائج *غير مصفّاة*، بينما في `signal_types` و`signal_strengths` يُطبَّق المرشح ولا يطابق *شيئًا*. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من [مرجع التوسع](/ar/api-reference/endpoint/expansions/types) وقارن `data.pagination.total_entries` مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة. scopes: $ref: '#/components/schemas/expansion_scopes' ahead_of_pace: type: boolean example: false description: >- التحديد للأزواج المتحركة أسرع من الوتيرة المعتادة لذلك السوق. 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' min_markets: type: integer example: 3 description: >- الحد الأدنى لعدد الأسواق الجديدة التي يجب أن تكون شركة قد دخلتها ضمن النافذة. home_country_code: type: array items: type: string example: - SG description: >- التصفية حسب دولة مقر الشركة (ISO 3166-1 alpha-2). تتقاطع مع `froms` عند توفير كليهما. industries: $ref: '#/components/schemas/industries' exclude_industries: $ref: '#/components/schemas/exclude_industries' 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' transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- نطاق تاريخ ISO لنافذة الجدول الزمني. الافتراضي آخر 90 يومًا. يمكن لاستعلام `query` بلغة طبيعية أيضًا ضبط هذا من عبارات تقويمية ("هذا العام"، "العام الماضي"، "الربع الثاني 2026"). window_days: $ref: '#/components/schemas/window_days' query: type: string example: fintech companies expanding into the UK description: استعلام بلغة طبيعية يفسّره Pubrio إلى مرشحات توسع + شركة. is_explain_match: type: boolean example: true description: >- أدرِج تفسيرات مولَّدة بالذكاء الاصطناعي لسبب مطابقة كل شركة للبحث، مستندة إلى الإشارات الحقيقية للشركة. الأنسب مع استعلام بلغة طبيعية. يتناسب عدد الإشارات المُستشهَد بها وحجم الدفعة مع `per_page`؛ تُلخَّص المصادر عالية الحجم (إعلانات الوظائف، الحملات الإعلانية) كعدد محدَّد بنافذة (مثل "12 إعلان وظيفة") بدلًا من سردها فرديًا. sort_by: $ref: '#/components/schemas/expansion_sort_by' is_include_metadata: allOf: - $ref: '#/components/schemas/expansion_is_include_metadata' description: >- أعِد حمولة التفاصيل الكاملة. حركة مرور مفتاح API مختصرة افتراضيًا: تُحذَف كتلة `model`، وأرقام الثقة (`stage.confidence` في تفاصيل توسع الشركة، و`confidence_score` في `other_markets[]` وفي `markers[]` الخاصة بالتصنيفات)، وحقول `established_min` / `share_of_detected` / `has_known_office` ما لم تكن هذه بقيمة `true`. page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' is_enable_similarity_search: type: boolean description: >- فعّل المطابقة بالنص الحر لـ `verticals` و`vertical_categories` و`vertical_sub_categories` و`technologies`؛ تُسقَط تلك المرشحات ما لم تكن هذه بقيمة `true`. example: true anyOf: - title: From Markets required: - froms - title: To Markets required: - tos - title: Plain-language Query required: - query - title: Companies required: - companies responses: '200': description: >- قائمة مرقّمة صفحيًا من الشركات المتوسعة في السوق (الأسواق). تعرض `filters` المعايير المطبَّقة (أو المفسَّرة من اللغة الطبيعية)؛ تتضمن كل شركة `match_summary` عندما تكون `is_explain_match` بقيمة true. content: application/json: schema: type: object properties: metadata: type: object description: >- بيانات وصفية للبحث: المرشحات المطبَّقة فعليًا، بالإضافة إلى تجميع السوق (الإجمالي، النطاق الجغرافي، أهم المصادر/الوجهات/الصناعات، الجدول الزمني). تتضمن استجابات مفتاح API التجميع فقط عندما تكون `is_include_metadata` بقيمة true. properties: filters: type: object description: >- المرشحات المطبَّقة فعليًا (تعرض استعلامًا مفسَّرًا باللغة الطبيعية عند استخدام `query`). relaxed_filters: type: array description: >- مرشحات مرنة أُسقطت تلقائيًا عندما لم يطابق استعلام باللغة الطبيعية شيئًا؛ فارغة (null) خلاف ذلك. items: type: string nl_note: type: string description: >- ملاحظة قابلة للقراءة عندما لم يعبّر استعلام باللغة الطبيعية عن أي معايير يمكن التعرّف عليها؛ القائمة فارغة في تلك الحالة. nl_note_code: type: string description: >- رمز قابل للقراءة آليًا لـ nl_note (مثل expansion.search.no_criteria). aggregate: type: object description: تجميع على مستوى السوق. موجود عند طلب البيانات الوصفية. country_code: type: string country_codes: type: array items: type: string direction: type: string is_global: type: boolean is_multi: type: boolean transitioned_dates: type: array items: type: string top_origins: type: array items: type: object top_destinations: type: array items: type: object top_industries: type: array items: type: object timeline: type: array items: type: object data: type: object description: >- حاوية النتائج (غلاف البحث القياسي): قائمة الشركات بالإضافة إلى الترقيم الصفحي. properties: pagination: type: object description: >- الصفحة، والعدد لكل صفحة، وإجمالي الإدخالات، وإجمالي الصفحات. companies: type: array description: >- قائمة الشركات. يحمل كل عنصر `stage` متداخلة؛ تُدرَج `match_summary` عندما تكون `is_explain_match` بقيمة true. تتضمن استجابات مفتاح API أيضًا `presence` (`level`: established | emerging | none | no_data؛ `matched_rule`: office | headcount | share) وكائن `read` تكون قيمة `code` فيه scaling | deepening | active | establishing (فارغة (null) عند عدم وجود حضور محلي لقراءته). items: type: object example: metadata: filters: tos: - GB verticals: - Financial Services data: pagination: page: 1 per_page: 25 total_entries: 87 total_pages: 4 total_display_pages: 4 is_timeout: false companies: - expansion_id: '6845525' domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: GB target_country_code: GB domain: example.com company_name: Example Corp home_country_code: CN industry: Consumer Electronics founded_year: 2015 employees_count: 320 stage: slug: expanding expansion_score: 0.72 scope: entering_new_market direction: advancing freshness: fresh signal_count: 27 distinct_type_count: 3 last_transition_at: '2026-06-27T14:32:10.000Z' presence: level: established local_people_count: 12 matched_rule: headcount has_known_office: true established_min: 10 share_of_detected: 0.54 read: code: establishing '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_momentum: type: array items: type: string enum: - advancing - steady - pulling_back example: - advancing - steady description: >- المسار المراد التصفية حسبه. يُقبَل فقط `advancing` و`steady` و`pulling_back`؛ قيم `directions` في [مرجع التوسع](/ar/api-reference/endpoint/expansions/types) هي جانب الاستجابة فقط. expansion_freshness: type: array items: type: string enum: - fresh - cooling - stale - cold example: - fresh - cooling description: >- التصفية حسب حداثة الدليل: حديثة (~30 يومًا)، تبرد (~30-60 يومًا)، قديمة (~60-90 يومًا)، باردة (>90 يومًا). expansion_scopes: type: array items: type: string enum: - entering_new_market - expanding_within_presence - established_only example: - entering_new_market 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، أعِد فقط التوسعات الموسومة بالانكماش (الشركات المتقلصة). industries: type: array items: type: string example: - software - financial services description: التصفية حسب اسم الصناعة (مطابقة نص حر). exclude_industries: type: array items: type: string example: - tobacco description: الصناعات المستبعدة (مطابقة نص حر). 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: >- نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك. window_days: type: integer example: 90 description: >- اختياري. حجم النافذة المتحركة بالأيام. يُستخدَم عندما لا يُوفَّر نطاق `transitioned_dates` صريح؛ إن حُذف كلاهما، تُستخدَم نافذة افتراضية. expansion_sort_by: type: string enum: - recent - expansion_score - signal_count - company_ranking example: expansion_score description: >- ترتيب النتائج. اتركه فارغًا لترتيب الصلة الافتراضي: الأزواج المدعَّمة أولًا (نوعا إشارة مميزان أو أكثر)، ثم أزواج الأدلة المتكررة (3 إشارات أو أكثر)، ثم البقية — الأحدث انتقالًا أولًا ضمن كل مستوى. `recent` — الحداثة الصرفة (الأحدث انتقالًا أولًا). `expansion_score` — أعلى درجة توسع أولًا. `signal_count` — أكثر إشارات في الزوج أولًا. `company_ranking` — ترتيب Pubrio الإجمالي للشركة (الأدنى أبرز)، تصاعديًا. expansion_is_include_metadata: type: boolean example: true description: >- استجابات مفتاح API مختصرة افتراضيًا. اضبط true لتضمين كتلة `metadata` الكاملة (التجميعات، أهم المصادر/الوجهات، أهم الصناعات، الجدول الزمني) وتفاصيل النموذج لكل شركة. 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**. 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` في بحث الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة. 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 ````