> ## 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/dashboard 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/dashboard: post: tags: - Expansion summary: Обзор экспансии description: >- Ключевые показатели экспансии на уровне рынка — количество компаний по стадиям на каждом рынке и основные трансграничные потоки. Агрегированные данные, без постраничной навигации. operationId: expansions_dashboard 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` фильтр применяется и не находит *ничего*. В любом случае ответ выглядит обычным. Получите допустимые слаги из [Expansion Reference](/en/api-reference/endpoint/expansions/types) и сравните `data.pagination.total_entries` с вызовом без фильтров, если набор результатов выглядит некорректно. momentum: allOf: - $ref: '#/components/schemas/expansion_momentum' description: >- Траектория движения компании на рынке. `advancing` — набирает позиции, `steady` — удерживает позиции, `pulling_back` охватывает отступление и сокращение. **Не используйте** здесь значения из `directions` в [Expansion Reference](/en/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` фильтр применяется и не находит *ничего*. В любом случае ответ выглядит обычным. Получите допустимые слаги из [Expansion Reference](/en/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` фильтр применяется и не находит *ничего*. В любом случае ответ выглядит обычным. Получите допустимые слаги из [Expansion Reference](/en/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` фильтр применяется и не находит *ничего*. В любом случае ответ выглядит обычным. Получите допустимые слаги из [Expansion Reference](/en/api-reference/endpoint/expansions/types) и сравните `data.pagination.total_entries` с вызовом без фильтров, если набор результатов выглядит некорректно. min_signal_count: type: integer example: 3 description: >- Минимальное количество сигналов экспансии, которое должно быть у компании за период — «очень активна / значительное присутствие». only_contraction: $ref: '#/components/schemas/only_contraction' 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-06-01' - '2026-06-29' description: >- Диапазон дат ISO [начало, конец] для окна отображения (карта, потоки и хронология списка наблюдения). По умолчанию — последние 90 дней. Показатель `new_transitions_30d` всегда использует собственное фиксированное 30-дневное окно независимо от этого диапазона. window_days: $ref: '#/components/schemas/window_days' 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' select_size: type: integer example: 250 description: >- Максимальное количество возвращаемых рынков (ограничено тарифом). flows_size: type: integer example: 50 description: >- Максимальное количество возвращаемых трансграничных потоков (ограничено тарифом). is_include_metadata: allOf: - $ref: '#/components/schemas/expansion_is_include_metadata' description: >- Вернуть полную детализированную полезную нагрузку. По умолчанию трафик по ключу API компактный: блок `model`, показатели достоверности (`stage.confidence` в Company Expansion Detail, `confidence_score` в `other_markets[]` и в `markers[]` Rankings), а также поля `established_min` / `share_of_detected` / `has_known_office` опускаются, если это значение не `true`. is_enable_similarity_search: type: boolean description: >- Включить сопоставление по свободному тексту для `verticals`, `vertical_categories`, `vertical_sub_categories` и `technologies`; эти фильтры отбрасываются, если это значение не `true`. example: true responses: '200': description: Агрегированные данные панели рынков. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: >- Контейнер панели: ранжированные рынки плюс основные потоки по коридорам. Устаревшее зеркальное отображение. Каждый контейнер внутри `data` также выводится на верхнем уровне (`countries`, `top_flows`, `picks_aggregate`, `watchlist_markets`, `watchlist_timeline`) для более старых клиентов. Считывайте их из `data` — копии на верхнем уровне будут удалены. properties: countries: type: array description: >- Ранжированные рынки с количеством сигналов по каждому рынку. items: type: object top_flows: type: array items: type: object description: >- Крупнейшие трансграничные потоки экспансии, от самых активных. picks_aggregate: type: array description: >- Агрегированная сводка по рынкам, соответствующим текущим фильтрам. items: type: object watchlist_markets: type: array description: >- Количество по стадиям на каждом рынке, ограниченное компаниями, сохранёнными в вашей рабочей области. items: type: object watchlist_timeline: type: array description: >- События перехода стадии для компаний, сохранённых в вашей рабочей области, от самых новых. items: type: object x-legacy-root-keys: - countries - top_flows - picks_aggregate - watchlist_markets - watchlist_timeline example: metadata: filters: froms: - CN tos: - GB select_size: 250 flows_size: 50 transitioned_dates: - '2026-06-01' - '2026-06-29' data: countries: - country_code: US inbound_count: 18 outbound_count: 5 total_companies_with_signals: 23 exploring_count: 8 committing_count: 10 expanding_count: 4 scaling_count: 1 new_transitions_30d: 3 pairs_ahead_of_pace_30d: 1 freshest_transition_at: '2026-06-27T14:32:10.000Z' top_flows: - home_country_code: SG country_code: US company_count: 5 new_transitions_30d: 1 '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 Signals. expansion_momentum: type: array items: type: string enum: - advancing - steady - pulling_back example: - advancing - steady description: >- Траектория для фильтрации. Принимаются только `advancing`, `steady` и `pulling_back`; значения `directions` в [Expansion Reference](/en/api-reference/endpoint/expansions/types) используются только в ответах. expansion_freshness: type: array items: type: string enum: - fresh - cooling - stale - cold example: - fresh - cooling description: >- Фильтр по актуальности подтверждающих данных: fresh (~30 дней), cooling (~30-60 дней), stale (~60-90 дней), cold (>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: >- Ограничить конкретными типами сигналов. Определения и уровни см. в каталоге Signal Types в базе знаний (`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, вернуть только экспансии с пометкой сокращения (компании, сворачивающие деятельность). verticals: type: array items: type: integer description: >- Список значений `vertical_id`, используемых для поиска компаний в конкретной отрасли. Чтобы найти ID, вызовите эндпоинт `vertical` на вкладке Filters. Этот фильтр поддерживает `is_enable_similarity_search`; при включении можно вводить произвольный текст, например `["AI"]`. vertical_categories: type: array items: type: integer description: >- Список значений `vertical_category_id`, используемых для поиска компаний в конкретной категории отрасли. Чтобы найти ID, вызовите эндпоинт `vertical category` на вкладке Filters. Этот фильтр поддерживает `is_enable_similarity_search`; при включении можно вводить произвольный текст, например `["Information Technology"]`. vertical_sub_categories: type: array items: type: integer description: >- Список значений `vertical_sub_category_id`, используемых для поиска компаний в конкретной подкатегории отрасли. Чтобы найти ID, вызовите эндпоинт `vertical sub category` на вкладке Filters. Этот фильтр поддерживает `is_enable_similarity_search`; при включении можно вводить произвольный текст, например `["Software"]`. technologies: type: array items: type: integer description: >- Список значений `tag_id`, используемых для поиска конкретных технологий, применяемых компаниями. Чтобы найти 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`, домена компании или URL профиля компании в социальных сетях. Домены и URL сопоставляются с наиболее подходящей компанией. 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` не указан; если не указаны оба, используется окно по умолчанию. industries: type: array items: type: string example: - software - financial services description: Фильтр по названию отрасли (сопоставление по свободному тексту). exclude_industries: type: array items: type: string example: - tobacco description: Отрасли для исключения (сопоставление по свободному тексту). expansion_is_include_metadata: type: boolean example: true description: >- Ответы по ключу API по умолчанию компактные. Установите true, чтобы включить полный блок `metadata` (агрегаты, топ источников/направлений, топ отраслей, хронология) и детали модели по каждой компании. 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, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````