> ## 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 API — какой эндпоинт вызывать для поиска, деталей по компании, ленты сигналов, сравнения, карт и справочных значений. Expansion API — это небольшой набор эндпоинтов, каждый из которых отвечает на свой вопрос о том, как компании выходят на новые рынки. Это руководство сопоставляет **то, что вы хотите сделать** с **тем, какой эндпоинт вызвать**, чтобы вам никогда не приходилось гадать. Впервые знакомитесь с концепциями (стадии, сигналы, momentum, свежесть)? Начните с [Что такое сигналы экспансии?](/ru/knowledge-base/concepts/expansion-signals) — это руководство предполагает, что вы уже их знаете, и фокусируется на выборе эндпоинта. ## Выбор по задаче | Вы хотите… | Вызвать | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | **Найти компании**, выходящие на рынок (по фильтрам или запросу на естественном языке) | [Expansion Search](/ru/api-reference/endpoint/expansions/market_lookup) | | Увидеть **KPI и потоки на уровне рынка** (количество по стадиям, топ коридоров) | [Expansion Overview](/ru/api-reference/endpoint/expansions/dashboard) | | Получить **статус одной компании на рынке** — стадию, присутствие, историю и сигналы, лежащие в основе | [Company Expansion Detail](/ru/api-reference/endpoint/expansions/company_lookup) | | Получить **обогащённую ленту событий сигналов компании** с окном по времени | [Company Signal Events](/ru/api-reference/endpoint/expansions/company_pulse_events) | | **Сравнить** экспансию нескольких компаний бок о бок, отталкиваясь от целевой компании | [Compare Company Expansions](/ru/api-reference/endpoint/expansions/company_compare) | | Получить **готовые к отображению метрики сравнения** (рынки, momentum, expansion score) для набора компаний, который у вас уже есть — по домену, URL LinkedIn или id | [Batch Company Expansion Summaries](/ru/api-reference/endpoint/expansions/company_summaries) | | Отобразить **ранжированные точки компаний/рынков** на карте или тепловой карте | [Expansion Rankings](/ru/api-reference/endpoint/expansions/company_markers) | | Прочитать **необработанные строки сигналов** за стадией — проверить доказательства или построить собственную систему оценки | [Expansion Signal Search](/ru/api-reference/endpoint/expansions/signal_search) | | Получить **значения фильтров и перечислений** (стадии, типы сигналов, свежесть…) | [Expansion Reference](/ru/api-reference/endpoint/expansions/types) | ## Эндпоинты одним взглядом Эндпоинт для поиска. Фильтруйте компании по стадии экспансии, свежести, рынку и полному набору фирмографических характеристик компании — или передайте запрос на естественном языке `query`. Список компаний с пагинацией. Агрегаты на уровне рынка: количество по стадиям, топ трансграничных потоков, активность отслеживаемых компаний. Без пагинации — снимок дашборда. Одна компания на одном рынке: текущая стадия, оценка, присутствие, история переходов и подтверждающие сигналы. Снимок по конкретному рынку. Обогащённая, постраничная лента событий сигналов компании по типам сигналов и окну дат. Детализация активности. Несколько компаний бок о бок в одном вызове, с еженедельными рядами сигналов и опциональным подбором аналогов. Создан для сравнительных сеток. Любой набор domain\_search\_id, domain или URL LinkedIn, разрешённый и возвращённый с теми же данными, что и Compare, плюс вычисленный блок сводки — без целевой компании, без подбора аналогов. Облегчённый список пар компания/рынок, ранжированный по оценке — минимальный набор полей, без пагинации — для быстрого отображения на карте и тепловой карте. Запрашивайте сами строки сигналов — тип, подтип, силу, полярность, событие с датой, источник и URL доказательства — по компаниям и рынкам. С пагинацией, фильтруемо, без сводки по компаниям. ## «Detail» против «Signal Events» — что выбрать? Это самый частый источник путаницы, потому что **оба задействуют сигналы**. Разница — *снимок против ленты*: | | Company Expansion Detail | Company Signal Events | | ---------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | **Область охвата** | одна компания × **один рынок** | одна компания, по **всем** её зарубежным рынкам | | **Рынки** | **один рынок** через `country_code`, либо вся компания сразу через `is_all_markets` | **все зарубежные рынки** по умолчанию (домашний рынок исключён); сужается до конкретных с помощью `country_codes` (массив) | | **Возвращает** | стадию, оценку, присутствие, историю **+ подтверждающие сигналы** | **обогащённые события сигналов** (URL доказательств, списки найма, метки) | | **Время** | текущее состояние | **окно по датам**, которое вы выбираете (`window_days` — по умолчанию 90 — или `transitioned_dates`) | | **Форма** | структурированный объект-снимок | постраничная лента событий («загрузить ещё») | | **Используйте, когда** | «Каков статус этой компании на **одном** рынке и почему?» | «Покажи мне полный поток по **каждому** рынку, движущему экспансию этой компании» | **Большинству интеграций достаточно Company Expansion Detail** — он уже возвращает сигналы, стоящие за стадией компании на рынке. Обращайтесь к **Company Signal Events**, когда вам нужен именно богатый, фильтруемый поток событий с окном по времени (например, при построении UI ленты активности). ## «Compare» против «Summaries» — что выбрать? Оба возвращают одни и те же данные экспансии по компаниям бок о бок. Разница — в *идентификаторах и постановке задачи*: | | Compare Company Expansions | Batch Company Expansion Summaries | | ---------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | **Ввод** | любой набор `domain_search_id`, `domain` или `linkedin_url` | любой набор `domain_search_id`, `domain` или `linkedin_url` | | **Подбор аналогов** | опционально, через `seed_target` | отсутствует — каждая компания независима | | **Вычисленная сводка** | нет (вычисляйте рынки/momentum/оценку самостоятельно) | блок `summary` включён для каждой компании (активные/новые рынки, momentum, expansion score, распределение по стадиям) | | **Используйте, когда** | у вас уже есть разрешённые id и вы хотите подобрать сопоставимых аналогов для одной цели | вам даны компании по домену или URL LinkedIn, и вы хотите получить готовые к отображению метрики сравнения за один вызов | **Строите сетку бенчмаркинга конкурентов вокруг целевой компании?** Используйте **Compare** с `seed_target` для автоматического подбора аналогов. **У вас уже есть набор компаний** (список наблюдения, импорт из CRM, список доменов) **и вам нужны просто цифры?** Используйте **Batch Company Expansion Summaries** — это избавит вас от повторной реализации расчёта momentum/оценки на стороне клиента. Таблица сравнения конкурентов с рынками, новыми рынками, momentum, активностью, expansion score и главным рынком экспансии для целевой компании и её конкурентов ## Типичный рабочий процесс Вызовите **Expansion Search** со своими фильтрами (или запросом на естественном языке `query`), чтобы получить компании, выходящие на целевой рынок. Установите `is_explain_match: true` для сводок ИИ «почему это совпадение». Возьмите `domain_search_id` из результатов и вызовите **Company Expansion Detail** для полного среза по рынку — стадия, присутствие, история и сигналы. Для богатого потока событий с окном по времени вызовите **Company Signal Events** с интересующими вас типами сигналов и диапазоном дат. Используйте **Compare Company Expansions** для сравнительной сетки, отталкивающейся от целевой компании, **Batch Company Expansion Summaries**, когда у вас уже есть набор компаний и вам нужны готовые метрики, либо **Expansion Rankings**, чтобы отобразить ранжированные точки на карте. ## Общие фильтры Эндпоинты обнаружения (**Expansion Search**, **Expansion Overview**, **Expansion Rankings**) принимают один и тот же словарь фильтров — фильтры экспансии (стадия, momentum, свежесть, область охвата, типы сигналов), пару направленной географии (`froms` / `tos`) **и** полный набор фирмографических характеристик компании (отрасль, технологии, размер по числу сотрудников, выручка, сохранённые списки). Изучите фильтры один раз в [Filters Overview](/ru/developer-guides/filters/overview); допустимые значения находятся в [Expansion Reference](/ru/api-reference/endpoint/expansions/types) и каталоге [How Expansion Signals Work](/ru/knowledge-base/concepts/how-expansion-signals-work). Аутентификация, первые вызовы, пагинация и чтение оценок. Полный разбор пути от рынка к сигналу.