> ## 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/lookup 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/lookup: post: tags: - Expansion summary: تفاصيل توسع الشركة description: >- ملف توسع متعمّق لشركة واحدة — المرحلة الحالية، الإشارات، الحضور السوقي، وسجل انتقال المراحل — لسوق واحدة أو مجمَّعًا عبر كل الأسواق. operationId: expansions_company_lookup requestBody: required: true content: application/json: schema: type: object properties: country_code: $ref: '#/components/schemas/expansion_country_code' is_all_markets: $ref: '#/components/schemas/expansion_is_all_markets' signal_type: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: EXEC description: صفِّ الإشارات المُعادة إلى نوع واحد. query: type: string example: >- We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity. description: >- وصف بلغة طبيعية لما تبيعه، أو ملف المشتري الذي تقيّم هذه الشركة مقابله. يُستخدَم فقط لتأسيس `summary` بالذكاء الاصطناعي (انظر `is_explain_match`)؛ بخلاف بحث الشركات، لا يُفسَّر إلى مرشحات هنا. is_explain_match: type: boolean example: true description: >- عند true وتوفير `query`، تُعيد `summary` ملخصًا واحدًا بالذكاء الاصطناعي لنشاط توسع هذه الشركة ضمن النطاق الحالي (السوق المختارة، أو كل الأسواق الأجنبية عندما تكون `is_all_markets` بقيمة true)، مقروءًا مقابل `query` الخاص بك ومستندًا إلى إشارات الشركة الحقيقية باستشهادات `[n]`. window_days: type: integer example: 90 default: 90 description: >- اختياري. نافذة متحركة (بالأيام) تحدّ تغذية `summary` بالذكاء الاصطناعي. الافتراضي **90** عندما لا يُوفَّر هذا ولا `transitioned_dates`. لا تؤثر على قائمة `signals` المرقّمة صفحيًا (السجل الكامل). transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- نطاق تاريخ ISO `[من, إلى]` لنافذة الإشارة/الانتقال. له الأولوية على `window_days` عند توفير كليهما. domain: $ref: '#/components/schemas/domain' linkedin_url: $ref: '#/components/schemas/company_linkedin_url' domain_search_id: $ref: '#/components/schemas/domain_search_id' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' 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 summary_only: type: boolean description: >- أعِد كتلة ملخص المرحلة فقط (`data`، `company`، `markets_summary`، `signal_weekly_totals`، `recent_signals`، `expansion_score`، `summary`) وتخطَّ قائمة الإشارات وتجميعاتها. أرخص بكثير لعروض الواجهة الرئيسية/الترويسة. example: true markets_summary_full: type: boolean description: >- أدرِج مجموعة السوق المرتبة الكاملة كـ `markets_summary` إلى جانب قائمة `other_markets` المحدودة. example: true anyOf: - title: Domain Search ID required: - domain_search_id - title: Domain required: - domain - title: LinkedIn URL required: - linkedin_url responses: '200': description: تفاصيل الشركة في السوق. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: حاوية النتائج. properties: domain_search_id: type: string description: معرّف شركة في Pubrio. country_code: type: string description: السوق المستهدفة، ISO 3166-1 alpha-2. country_name: type: string description: اسم السوق المستهدفة. stage_rank: type: integer description: الترتيب الرقمي للمرحلة، الأعلى يعني تقدمًا أكبر. stage_name: type: string description: اسم عرض المرحلة. stage: type: object description: >- تفاصيل المرحلة — الدرجة، النطاق، الاتجاه، الحداثة، وأعداد الإشارات. local_people_count: type: integer description: الموظفون الموجودون في السوق المستهدفة. local_people_coverage: type: boolean description: ما إذا كانت تغطية عدد الموظفين كافية للوثوق بالعدد. presence: type: object description: >- البصمة السوقية: مدى استقرار الشركة بالفعل، بمعزل عن مرحلة توسعها. properties: level: type: string enum: - established - emerging - none - no_data description: >- مدى استقرار بصمة الشركة في هذا السوق: `established`، `emerging`، `none`، أو `no_data`. هذه هي البصمة، لا مرحلة التوسع. local_people_count: type: integer description: الموظفون الموجودون في السوق المستهدفة. matched_rule: type: string nullable: true description: >- أي إشارة حدَّدت المستوى — مثل `office` أو `headcount` أو `share`. `null` عند عدم مطابقة أي قاعدة. read: type: object description: حالة القراءة لهذا السجل. signals: type: array description: >- صفوف الإشارات المرقّمة صفحيًا وراء زوج الشركة/السوق هذا — قائمة الأدلة. حجم الصفحة والإجماليات تأتي من `metadata.pagination`. items: type: object summary: type: object description: ملخص مرحلة من سطر واحد للزوج. الصفحة الأولى فقط. company: type: object description: >- معلومات الشركة الأساسية — الاسم، النطاق، الشعار، وروابط اجتماعية. الصفحة الأولى فقط. signal_group_totals: type: array description: >- أعداد الإشارات لكل نوع، مقسَّمة حسب اليوم بتوقيت منطقتك. الصفحة الأولى فقط. items: type: object signal_type_totals: type: array description: >- إجماليات الإشارات لكل الأوقات لكل نوع إشارة. الصفحة الأولى فقط. items: type: object signal_type_recent_totals: type: array description: >- إجماليات الإشارات لكل نوع خلال آخر 12 أسبوعًا. الصفحة الأولى فقط. items: type: object signal_weekly_totals: type: array description: >- أعداد الإشارات الأسبوعية للخريطة الحرارية، بنفس نافذة `signal_type_recent_totals`. الصفحة الأولى فقط. items: type: object evidence_breakdown: type: object description: >- تجميع الأدلة حسب نوع المصدر، محسوب من الإشارات المُعادة (المُنقَّحة). الصفحة الأولى فقط. presence: type: object description: >- الحضور المادي والرقمي المرصود للشركة في هذا السوق. الصفحة الأولى فقط. suppressions: type: array description: >- الإشارات المُستبعَدة من حساب المرحلة، مع سبب كل استبعاد. الصفحة الأولى فقط. items: type: object timeline: type: array description: >- سجل انتقال المرحلة لزوج الشركة/السوق هذا. الصفحة الأولى فقط. items: type: object other_markets: type: array description: >- الأسواق النشطة الأخرى للشركة. محدودة في الخطط المقيَّدة — انظر `other_markets_locked_count`. الصفحة الأولى فقط. items: type: object other_markets_locked_count: type: integer description: >- عدد الأسواق الإضافية التي لم تُعدها خطتك في `other_markets`. `0` عند عدم حجب أي شيء. markets_summary: type: array description: >- مجموعة السوق المرتبة الكاملة لهذه الشركة. تُعاد فقط عندما تكون `markets_summary_full` بقيمة `true`، في الصفحة الأولى. items: type: object example: metadata: filters: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US country_code_auto_picked: false pagination: page: 1 per_page: 25 total_entries: 12 total_pages: 1 total_display_pages: 1 is_timeout: false data: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US country_name: United States stage_rank: 3 stage_name: Expanding stage: slug: expanding expansion_score: 0.721 scope: entering_new_market direction: advancing freshness: fresh contraction_flag: null mode_change_flag: false signal_count: 5 distinct_type_count: 3 has_known_presence: false first_signal_at: '2026-05-30T09:00:00.000Z' latest_signal_at: '2026-06-20T14:00:00.000Z' last_transition_at: '2026-06-15T09:30:00.000Z' signals: - signal_type_slug: EXEC signal_subtype_slug: country_manager signal_strength_slug: high polarity: expansion event_date: '2026-06-20T14:00:00.000Z' source_type: linkedin display_label: Hired Regional VP for North America evidence_url: https://linkedin.com/company/example-corp source_published_at: '2026-06-20T14:00:00.000Z' lead_time_days: 0 presence: - presence_type: office presence_strength: high address: 123 Market St, San Francisco, CA known_since: '2026-03-15T00:00:00.000Z' timeline: - stage_slug: expanding transitioned_at: '2026-06-15T09:30:00.000Z' transition_kind: advance other_markets: - country_code: CA stage_slug: committing signal_count: 8 first_signal_at: '2026-04-10T00:00:00.000Z' latest_signal_at: '2026-06-22T16:45:00.000Z' last_transition_at: '2026-06-18T00:00:00.000Z' '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_country_code: type: string example: US description: >- السوق المستهدفة كرمز دولة ISO 3166-1 alpha-2 (cca2). احذفه ليُختار تلقائيًا أنشط سوق واحدة للشركة؛ اضبط `is_all_markets` لعرض عبر كل الأسواق. expansion_is_all_markets: type: boolean example: false description: >- أعِد بصمة توسع الشركة بأكملها عبر كل الأسواق في استدعاء واحد، بدلًا من سوق واحدة. عند `true`، تُهمَل `country_code`، وتُستبعَد دولة المقر من تجميعات الإشارات عندما يمكن تحديدها، وتصبح `data` تجميعًا على مستوى الشركة (المرحلة السائدة، إجمالي الإشارات، مدى التاريخ، أعلى درجة توسع)، وتسرد `markets_summary` كل سوق. الافتراضي false. domain: type: string example: pubrio.com description: >- نطاق شركة يُستخدَم لعمليات البحث عن شركات. إن استلمنا رابطًا مثل `www.pubrio.com` أو `https://docs.pubrio.com/`، سيحوّله النظام إلى `pubrio.com` للمعالجة. company_linkedin_url: type: string example: https://www.linkedin.com/company/pubrio description: >- الرابط الكامل لملف شركة على LinkedIn. يبدأ الرابط بـ`http` ويحتوي `linkedin.com/company/` domain_search_id: type: string format: uuid description: معرّف فريد لعملية البحث عن شركات. expansion_is_include_established: type: boolean example: false description: >- أدرِج مرحلة `established` (المشغّلون العريقون دون إشارات توسع نشطة). الافتراضي false. 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` في بحث الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة. 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 ````