> ## 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 ru-openapi POST /expansions/companies/lookup openapi: 3.0.0 info: description: >- API Pubrio предоставляет данные об экспансии на рынки — сигналы в реальном времени, отмечающие выход компании на новый рынок, — вместе с лежащими в их основе данными о компаниях и людях. Выполняйте поиск, просмотр и обогащение данных об аккаунтах и контактах, а также подписывайтесь на типизированные сигналы движения с указанием даты по более чем 200 рынкам. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ru/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ru/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: Просмотр данных о людях и компаниях по URL профиля LinkedIn - name: Redeem description: >- Погашение кредитов для получения контактных данных людей (по одному и пакетно) - name: Channels description: >- Управление шаблонами каналов для рассылок (создание, обновление, удаление, список) - name: Monitor description: >- Создание мониторов данных и управление ими с вебхуками, статистикой и обработкой - name: Filters description: >- Получение доступных значений фильтров для параметров поиска (технологии, местоположения, отрасли и т. д.) - name: API Keys description: >- Просмотр списка и анализ журналов запросов API и статистики использования ключей API - name: Insights description: Агрегированные данные по сигналам компаний (вакансии, новости, реклама). - name: Export description: Массовый экспорт данных (расходует кредиты). - name: Expansion description: 'Данные об экспансии компаний на рынки: сигналы, стадии, рынки и экспорт.' externalDocs: description: >- API Pubrio используется для поиска, предварительного просмотра и обогащения контактов и аккаунтов. База данных Pubrio предоставляет обширные B2B-контакты и данные для анализа продаж. 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: >- Необязательно. Скользящее окно (в днях), ограничивающее ленту для сводки от ИИ. По умолчанию **90**, если не указаны ни этот параметр, ни `transitioned_dates`. Не влияет на постраничный список `signals` (полная история). transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- Диапазон дат ISO `[from, to]` для окна сигналов/переходов. Имеет приоритет над `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` в Company Expansion Detail, `confidence_score` в `other_markets[]` и в `markers[]` Rankings), а также поля `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: >- Основные данные компании — название, домен, логотип и URL социальных сетей. Только на первой странице. 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: >- Домен компании, используемый для операций поиска компаний. Если получен URL вида `www.pubrio.com` или `https://docs.pubrio.com/`, система преобразует его в `pubrio.com` для обработки. company_linkedin_url: type: string example: https://www.linkedin.com/company/pubrio description: >- Полностью сформированный URL профиля компании в LinkedIn. URL начинается с `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](/en/api-reference/endpoint/profile/profile). Превышение возвращает **HTTP 416**. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Количество записей на странице. По умолчанию — 25, что также является пределом на большинстве тарифов — лимит определяется параметром `max_search_per_page` вашей подписки, который возвращает [Profile](/en/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, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````