> ## 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.

# اختيار نقطة نهاية Expansion

> دليل يربط المهمة بنقطة النهاية المناسبة في Expansion API — أي نقطة نهاية تستدعيها للاكتشاف، وتفاصيل الشركة، وتدفق الإشارات، والمقارنة، والخرائط، والقيم المرجعية.

تتكون Expansion API من مجموعة صغيرة من نقاط النهاية، تجيب كل واحدة منها عن سؤال مختلف حول كيفية توسّع الشركات إلى أسواق جديدة. يربط هذا الدليل بين **ما تريد فعله** و**نقطة النهاية التي يجب استدعاؤها**، حتى لا تضطر أبدًا إلى التخمين.

<Info>
  هل المفاهيم (المراحل، الإشارات، الزخم، الحداثة) جديدة عليك؟ ابدأ بصفحة [ما هي إشارات Expansion؟](/ar/knowledge-base/concepts/expansion-signals) — يفترض هذا الدليل أنك تعرفها بالفعل ويركّز على اختيار نقطة النهاية.
</Info>

## اختر حسب المهمة

| تريد أن...                                                                                                                               | استدعِ                                                                                  |
| ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| **تجد شركات** تتوسّع في سوق ما (عبر الفلاتر أو استعلام بلغة طبيعية)                                                                      | [بحث Expansion](/ar/api-reference/endpoint/expansions/market_lookup)                    |
| ترى **مؤشرات أداء وتدفقات على مستوى السوق** (أعداد لكل مرحلة، أهم الممرات)                                                               | [نظرة عامة على Expansion](/ar/api-reference/endpoint/expansions/dashboard)              |
| تحصل على **حالة شركة واحدة في سوق ما** — المرحلة، الحضور، التاريخ، والإشارات وراءها                                                      | [تفاصيل توسّع الشركة](/ar/api-reference/endpoint/expansions/company_lookup)             |
| تحصل على **تدفق مُثرى ومحدد بنافذة زمنية** لأحداث إشارات شركة ما                                                                         | [أحداث إشارات الشركة](/ar/api-reference/endpoint/expansions/company_pulse_events)       |
| **تقارن** توسّع عدة شركات جنبًا إلى جنب، انطلاقًا من شركة مستهدفة                                                                        | [مقارنة توسّع الشركات](/ar/api-reference/endpoint/expansions/company_compare)           |
| تحصل على **مقاييس مقارنة جاهزة للعرض** (الأسواق، الزخم، درجة التوسّع) لمجموعة شركات لديك بالفعل — عبر النطاق أو رابط LinkedIn أو المعرّف | [ملخصات توسّع الشركات الدفعية](/ar/api-reference/endpoint/expansions/company_summaries) |
| ترسم **نقاط شركة/سوق مرتّبة** على خريطة أو خريطة حرارية                                                                                  | [تصنيفات Expansion](/ar/api-reference/endpoint/expansions/company_markers)              |
| تقرأ **صفوف الإشارات الخام** وراء مرحلة ما — لتدقيق الأدلة، أو بناء نظام تقييم خاص بك                                                    | [بحث إشارات Expansion](/ar/api-reference/endpoint/expansions/signal_search)             |
| تحلّ **قيم الفلاتر والتعدادات** (المراحل، أنواع الإشارات، الحداثة...)                                                                    | [مرجع Expansion](/ar/api-reference/endpoint/expansions/types)                           |

## نظرة سريعة على نقاط النهاية

<CardGroup cols={2}>
  <Card title="بحث Expansion" icon="magnifying-glass" href="/ar/api-reference/endpoint/expansions/market_lookup">
    نقطة نهاية الاكتشاف. صفِّ الشركات حسب مرحلة التوسّع، والحداثة، والسوق، وكامل مجموعة السمات الوصفية للشركة — أو مرِّر `query` بلغة طبيعية. قائمة شركات مقسّمة إلى صفحات.
  </Card>

  <Card title="نظرة عامة على Expansion" icon="chart-simple" href="/ar/api-reference/endpoint/expansions/dashboard">
    تجميعات على مستوى السوق: أعداد لكل مرحلة، وأهم تدفقات عبر الحدود، ونشاط الشركات المراقَبة. بلا ترقيم صفحات — لقطة لوحة تحكم.
  </Card>

  <Card title="تفاصيل توسّع الشركة" icon="building-magnifying-glass" href="/ar/api-reference/endpoint/expansions/company_lookup">
    شركة واحدة في سوق واحد: المرحلة الحالية، الدرجة، الحضور، تاريخ الانتقالات، والإشارات الداعمة. لقطة على مستوى السوق الواحد.
  </Card>

  <Card title="أحداث إشارات الشركة" icon="timeline" href="/ar/api-reference/endpoint/expansions/company_pulse_events">
    التدفق المُثرى والمقسّم إلى صفحات لأحداث إشارات شركة ما عبر أنواع الإشارات ونافذة زمنية. التعمّق في النشاط.
  </Card>

  <Card title="مقارنة توسّع الشركات" icon="scale-balanced" href="/ar/api-reference/endpoint/expansions/company_compare">
    عدة شركات جنبًا إلى جنب في استدعاء واحد، مع سلاسل إشارات أسبوعية وتزويد اختياري بشركات نظيرة. مصممة لشبكات المقارنة.
  </Card>

  <Card title="ملخصات توسّع الشركات الدفعية" icon="table" href="/ar/api-reference/endpoint/expansions/company_summaries">
    أي مزيج من domain\_search\_id أو النطاق أو رابط LinkedIn، يُحلّ ويُعاد بنفس بيانات المقارنة إضافةً إلى كتلة ملخّص محسوبة — دون شركة مستهدفة ودون تزويد بشركات نظيرة.
  </Card>

  <Card title="تصنيفات Expansion" icon="map-location-dot" href="/ar/api-reference/endpoint/expansions/company_markers">
    قائمة خفيفة ومرتّبة حسب الدرجة لأزواج شركة/سوق — بحقول أساسية فقط وبلا ترقيم صفحات — لعرض سريع على الخرائط والخرائط الحرارية.
  </Card>

  <Card title="بحث إشارات Expansion" icon="signal-stream" href="/ar/api-reference/endpoint/expansions/signal_search">
    استعلم عن صفوف الإشارات نفسها — النوع، النوع الفرعي، القوة، الاتجاه، الحدث المؤرَّخ، المصدر ورابط الدليل — عبر الشركات والأسواق. مقسّم إلى صفحات، قابل للتصفية، دون تجميع على مستوى الشركة.
  </Card>
</CardGroup>

## "التفاصيل" مقابل "أحداث الإشارات" — أيهما تختار؟

هذه أكثر نقطة تسبب الالتباس، لأن **كليهما يتضمن إشارات**. الفرق هو *اللقطة مقابل التدفق*:

|                    | تفاصيل توسّع الشركة                                                                | أحداث إشارات الشركة                                                                                                   |
| ------------------ | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **النطاق**         | شركة واحدة × **سوق واحد**                                                          | شركة واحدة، عبر **جميع أسواقها الخارجية**                                                                             |
| **الأسواق**        | **سوق واحد** عبر `country_code`، أو الشركة بأكملها دفعة واحدة عبر `is_all_markets` | **جميع الأسواق الخارجية** افتراضيًا (باستثناء السوق المحلي)؛ ضيّق النطاق إلى أسواق محددة عبر `country_codes` (مصفوفة) |
| **يُرجع**          | المرحلة، الدرجة، الحضور، التاريخ **+ الإشارات الداعمة**                            | **أحداث إشارات مُثراة** (روابط أدلة، قوائم توظيف، تصنيفات)                                                            |
| **الزمن**          | الوضع الحالي                                                                       | **نافذة زمنية** تختارها (`window_days` — الافتراضي 90 — أو `transitioned_dates`)                                      |
| **الشكل**          | كائن لقطة مُهيكل                                                                   | تدفق أحداث مقسّم إلى صفحات ("تحميل المزيد")                                                                           |
| **استخدمها عندما** | "ما حالة هذه الشركة في سوق **واحد**، ولماذا؟"                                      | "أرِني التدفق الكامل عبر **كل** الأسواق التي تدفع توسّع هذه الشركة"                                                   |

<Tip>
  **معظم عمليات الدمج تحتاج فقط إلى تفاصيل توسّع الشركة** — فهي بالفعل تُرجع الإشارات وراء مرحلة الشركة في سوق ما. استخدم **أحداث إشارات الشركة** عندما تحتاج تحديدًا إلى تدفق أحداث غني وقابل للتصفية ومحدد بنافذة زمنية (مثل بناء واجهة جدول زمني للنشاط).
</Tip>

## "المقارنة" مقابل "الملخصات" — أيهما تختار؟

كلاهما يُرجع نفس بيانات توسّع كل شركة جنبًا إلى جنب. الفرق هو *المعرّفات وسياق الاستخدام*:

|                        | مقارنة توسّع الشركات                                                                      | ملخصات توسّع الشركات الدفعية                                                                 |
| ---------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **المدخلات**           | أي مزيج من `domain_search_id` أو `domain` أو `linkedin_url`                               | أي مزيج من `domain_search_id` أو `domain` أو `linkedin_url`                                  |
| **تزويد بشركات نظيرة** | اختياري، عبر `seed_target`                                                                | لا يوجد — كل شركة مستقلة                                                                     |
| **التجميع المحسوب**    | لا يوجد (احسب الأسواق/الزخم/الدرجة بنفسك)                                                 | كتلة `summary` مضمّنة لكل شركة (أسواق نشطة/جديدة، الزخم، درجة التوسّع، مزيج المراحل)         |
| **استخدمها عندما**     | لديك بالفعل معرّفات مُحلّلة وتريد تزويد شركات نظيرة قابلة للمقارنة حول شركة مستهدفة واحدة | تحصل على الشركات عبر النطاق أو رابط LinkedIn وتريد مقاييس مقارنة جاهزة للعرض في استدعاء واحد |

<Tip>
  **هل تبني شبكة مقارنة تنافسية حول شركة مستهدفة؟** استخدم **المقارنة** مع `seed_target` لاختيار الشركات النظيرة تلقائيًا. **لديك بالفعل مجموعة شركات** (قائمة مراقبة، استيراد من CRM، قائمة نطاقات) **وتريد الأرقام فقط؟** استخدم **ملخصات توسّع الشركات الدفعية** — فهي توفّر عليك إعادة تنفيذ حسابات الزخم/الدرجة من جهة العميل.
</Tip>

<Frame caption="مقارنة توسّع الشركات، معروضة كشبكة — الأسواق، والزخم، ودرجة التوسع، وأحدث الإدخالات، جنبًا إلى جنب.">
  <img src="https://mintcdn.com/pubrio/D7-S_msGUHbXRYZf/images/expansion/comparison.png?fit=max&auto=format&n=D7-S_msGUHbXRYZf&q=85&s=380195f83946d1fdb1c8d1a6b1d93ddf" alt="جدول مقارنة منافسين يعرض الأسواق، والأسواق الجديدة، والزخم، والنشاط، ودرجة التوسع، وأهم سوق توسع لشركة مستهدفة ومنافسيها" width="3022" height="1570" data-path="images/expansion/comparison.png" />
</Frame>

## سير عمل نموذجي

<Steps>
  <Step title="اكتشف" icon="magnifying-glass">
    استدعِ **بحث Expansion** بفلاترك (أو استعلام `query` بلغة طبيعية) للحصول على الشركات المتوسّعة في سوقك المستهدف. اضبط `is_explain_match: true` للحصول على ملخصات "لماذا تطابقت" المولّدة بالذكاء الاصطناعي.
  </Step>

  <Step title="تعمّق في شركة" icon="building-magnifying-glass">
    خذ `domain_search_id` من النتائج واستدعِ **تفاصيل توسّع الشركة** للحصول على القراءة الكاملة في سوق ما — المرحلة، الحضور، التاريخ، والإشارات.
  </Step>

  <Step title="اطّلع على تدفق النشاط (اختياري)" icon="timeline">
    للحصول على تدفق أحداث غني ومحدد بنافذة زمنية، استدعِ **أحداث إشارات الشركة** بأنواع الإشارات ونطاق التاريخ اللذين يهمانك.
  </Step>

  <Step title="قارِن أو ارسم على خريطة" icon="scale-balanced">
    استخدم **مقارنة توسّع الشركات** لشبكة جنبًا إلى جنب انطلاقًا من شركة مستهدفة، أو **ملخصات توسّع الشركات الدفعية** عندما تملك بالفعل مجموعة شركات وتريد مقاييس جاهزة، أو **تصنيفات Expansion** لرسم نقاط مرتّبة على خريطة.
  </Step>
</Steps>

## الفلاتر المشتركة

تقبل نقاط نهاية الاكتشاف (**بحث Expansion**، **نظرة عامة على Expansion**، **تصنيفات Expansion**) نفس مفردات الفلاتر — فلاتر Expansion (المرحلة، الزخم، الحداثة، النطاق، أنواع الإشارات)، وزوج الجغرافيا الموجّه (`froms` / `tos`)، **و**كامل مجموعة السمات الوصفية للشركة (الصناعة، التقنيات، حجم الموظفين، الإيرادات، القوائم المحفوظة). تعلّم الفلاتر مرة واحدة في [نظرة عامة على الفلاتر](/ar/developer-guides/filters/overview)؛ القيم الصالحة موجودة في [مرجع Expansion](/ar/api-reference/endpoint/expansions/types) وفهرس [كيف تعمل إشارات Expansion](/ar/knowledge-base/concepts/how-expansion-signals-work).

<CardGroup cols={2}>
  <Card title="استخدام Expansion API" icon="code" href="/ar/knowledge-base/concepts/expansion-api-quickstart">
    المصادقة، استدعاءاتك الأولى، ترقيم الصفحات، وقراءة الدرجات.
  </Card>

  <Card title="مثال عملي" icon="route" href="/ar/knowledge-base/concepts/expansion-signals-example">
    شرح كامل من السوق إلى الإشارة.
  </Card>
</CardGroup>