> ## 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/search
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/search:
    post:
      tags:
        - Expansion
      summary: Поиск по экспансии
      description: >-
        Поиск компаний, выходящих на один или несколько рынков, с использованием
        фирмографических фильтров и фильтров сигналов или запроса на
        естественном языке, с возможными пояснениями совпадений от ИИ,
        основанными на реальных сигналах каждой компании.
      operationId: expansions_search
      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'
                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'
                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-04-01'
                    - '2026-06-29'
                  description: >-
                    Диапазон дат ISO для окна хронологии. По умолчанию —
                    последние 90 дней. Запрос `query` на естественном языке
                    также может задавать его через календарные фразы («в этом
                    году», «в прошлом году», «второй квартал 2026»).
                window_days:
                  $ref: '#/components/schemas/window_days'
                query:
                  type: string
                  example: fintech companies expanding into the UK
                  description: >-
                    Запрос на естественном языке, который Pubrio интерпретирует
                    в фильтры экспансии и компании.
                is_explain_match:
                  type: boolean
                  example: true
                  description: >-
                    Включить сгенерированные ИИ пояснения того, почему каждая
                    компания соответствует поиску, основанные на реальных
                    сигналах компании. Лучше всего сочетается с запросом на
                    естественном языке. Количество цитируемых сигналов и размер
                    пакета масштабируются вместе с `per_page`; источники с
                    большим объёмом (вакансии, рекламные кампании) кратко
                    представляются как количество за период (например, «12
                    вакансий»), а не перечисляются по отдельности.
                sort_by:
                  $ref: '#/components/schemas/expansion_sort_by'
                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`.
                page:
                  $ref: '#/components/schemas/page'
                per_page:
                  $ref: '#/components/schemas/per_page'
                is_enable_similarity_search:
                  type: boolean
                  description: >-
                    Включить сопоставление по свободному тексту для `verticals`,
                    `vertical_categories`, `vertical_sub_categories` и
                    `technologies`; эти фильтры отбрасываются, если это значение
                    не `true`.
                  example: true
              anyOf:
                - title: From Markets
                  required:
                    - froms
                - title: To Markets
                  required:
                    - tos
                - title: Plain-language Query
                  required:
                    - query
                - title: Companies
                  required:
                    - companies
      responses:
        '200':
          description: >-
            Постраничный список компаний, выходящих на рынок(и). `filters`
            отражает применённые (или интерпретированные из естественного языка)
            критерии; каждая компания включает `match_summary`, если
            `is_explain_match` равен true.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    description: >-
                      Метаданные поиска: фактически применённые фильтры, а также
                      сводка по рынку (агрегат, географический охват, топ
                      источников/направлений/отраслей, хронология). Ответы по
                      ключу API включают сводку только если
                      `is_include_metadata` равен true.
                    properties:
                      filters:
                        type: object
                        description: >-
                          Фактически применённые фильтры (отражает
                          интерпретированный запрос на естественном языке, если
                          использовался `query`).
                      relaxed_filters:
                        type: array
                        description: >-
                          Мягкие фильтры, автоматически отброшенные, когда
                          запрос на естественном языке ничего не нашёл; в
                          противном случае null.
                        items:
                          type: string
                      nl_note:
                        type: string
                        description: >-
                          Понятное человеку примечание, когда запрос на
                          естественном языке не содержал распознаваемых
                          критериев; в этом случае список пуст.
                      nl_note_code:
                        type: string
                        description: >-
                          Машиночитаемый код для nl_note (например,
                          expansion.search.no_criteria).
                      aggregate:
                        type: object
                        description: >-
                          Сводка на уровне рынка. Присутствует, если запрошены
                          метаданные.
                      country_code:
                        type: string
                      country_codes:
                        type: array
                        items:
                          type: string
                      direction:
                        type: string
                      is_global:
                        type: boolean
                      is_multi:
                        type: boolean
                      transitioned_dates:
                        type: array
                        items:
                          type: string
                      top_origins:
                        type: array
                        items:
                          type: object
                      top_destinations:
                        type: array
                        items:
                          type: object
                      top_industries:
                        type: array
                        items:
                          type: object
                      timeline:
                        type: array
                        items:
                          type: object
                  data:
                    type: object
                    description: >-
                      Контейнер результатов (стандартная оболочка поиска):
                      список компаний плюс данные пагинации.
                    properties:
                      pagination:
                        type: object
                        description: >-
                          Страница, количество на странице, общее число записей
                          и общее число страниц.
                      companies:
                        type: array
                        description: >-
                          Список компаний. Каждый элемент содержит вложенный
                          `stage`; `match_summary` включается, если
                          `is_explain_match` равен true. Ответы по ключу API
                          также включают `presence` (`level`: established |
                          emerging | none | no_data; `matched_rule`: office |
                          headcount | share) и объект `read`, чей `code`
                          принимает значения scaling | deepening | active |
                          establishing (null, если нет локального присутствия
                          для считывания).
                        items:
                          type: object
              example:
                metadata:
                  filters:
                    tos:
                      - GB
                    verticals:
                      - Financial Services
                data:
                  pagination:
                    page: 1
                    per_page: 25
                    total_entries: 87
                    total_pages: 4
                    total_display_pages: 4
                    is_timeout: false
                  companies:
                    - expansion_id: '6845525'
                      domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c
                      country_code: GB
                      target_country_code: GB
                      domain: example.com
                      company_name: Example Corp
                      home_country_code: CN
                      industry: Consumer Electronics
                      founded_year: 2015
                      employees_count: 320
                      stage:
                        slug: expanding
                        expansion_score: 0.72
                        scope: entering_new_market
                        direction: advancing
                        freshness: fresh
                        signal_count: 27
                        distinct_type_count: 3
                        last_transition_at: '2026-06-27T14:32:10.000Z'
                      presence:
                        level: established
                        local_people_count: 12
                        matched_rule: headcount
                        has_known_office: true
                        established_min: 10
                        share_of_detected: 0.54
                      read:
                        code: establishing
        '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, вернуть только экспансии с пометкой сокращения (компании,
        сворачивающие деятельность).
    industries:
      type: array
      items:
        type: string
      example:
        - software
        - financial services
      description: Фильтр по названию отрасли (сопоставление по свободному тексту).
    exclude_industries:
      type: array
      items:
        type: string
      example:
        - tobacco
      description: Отрасли для исключения (сопоставление по свободному тексту).
    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` не указан; если не указаны оба,
        используется окно по умолчанию.
    expansion_sort_by:
      type: string
      enum:
        - recent
        - expansion_score
        - signal_count
        - company_ranking
      example: expansion_score
      description: >-
        Порядок результатов. Не указывайте для порядка по релевантности по
        умолчанию: сначала подтверждённые пары (2+ разных типов сигналов), затем
        пары с повторяющимися подтверждениями (3+ сигнала), затем остальные —
        внутри каждого уровня сначала недавно перешедшие. `recent` — по чистой
        актуальности (сначала недавно перешедшие). `expansion_score` — сначала с
        наивысшим показателем экспансии. `signal_count` — сначала с наибольшим
        числом сигналов в паре. `company_ranking` — общий рейтинг компании в
        Pubrio (меньше — заметнее), по возрастанию.
    expansion_is_include_metadata:
      type: boolean
      example: true
      description: >-
        Ответы по ключу API по умолчанию компактные. Установите true, чтобы
        включить полный блок `metadata` (агрегаты, топ источников/направлений,
        топ отраслей, хронология) и детали модели по каждой компании.
    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` для поиска компаний
        и людей), а не усечённый набор результатов.
    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

````