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

# Перечисления и константы

> Все фиксированные значения, которые принимает или возвращает Pubrio API — ранги должности, функции работы, источники и форматы объявлений, уровни охвата, типы сигналов, уровни менеджмента — на одной странице.

Большинство фильтров Pubrio принимают **слаг** из закрытого списка. Короткие списки приведены здесь полностью. Длинные, изменяющиеся списки (страны, технологии, вертикали, категории новостей) поступают из эндпоинтов группы **Фильтры**, и на этой странице указано, из какого именно.

<Warning>
  Большинство фильтров поиска **не отклоняют** неизвестное значение. Одни отбрасывают фильтр и возвращают всё (`seniority_ranks`), другие применяют его и не возвращают ничего (`functions`, `source_types`, `reach_tiers`). Оба случая выглядят как обычный `200`. Всегда проверяйте `metadata.ignored_fields`, а при поиске объявлений — ещё и `metadata.unsupported_source_types`.
</Warning>

## Соглашения

| Форма                                                             | Значение                                                                                                                                                                                                                              | Пример                         |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `["YYYY-MM-DD", "YYYY-MM-DD"]`                                    | Включительный диапазон дат `[от, до]`. Границы дня следуют часовому поясу вашей рабочей области, за исключением `launch_dates` и `active_dates`, которые используют UTC. Там, где это указано, один элемент означает конкретный день. | `["2026-08-01", "2026-08-31"]` |
| Дата или ISO-метка времени (скаляр: `created_at`, `published_at`) | В этот момент или позже, сравнение в UTC.                                                                                                                                                                                             | `"2026-09-02T12:00:00Z"`       |
| `[min, max]` с `null`                                             | Числовой диапазон; `null` оставляет соответствующую границу открытой.                                                                                                                                                                 | `[1, null]` = не менее одного  |
| Массивы слагов                                                    | Совпадение с **любым** указанным значением (OR), если вы не переведёте ключ в режим AND с помощью [`filter_conditions`](/ru/developer-guides/filters/filter-conditions).                                                              | `["linkedin", "facebook"]`     |
| Коды стран                                                        | ISO 3166-1 alpha-2, в верхнем регистре. Полный список — на странице [Locations](/ru/api-reference/endpoint/locations/locations).                                                                                                      | `"US"`, `"SG"`                 |

***

## Поиск вакансий

Используется в [Поиске вакансий](/ru/api-reference/endpoint/companies/job_search) и присутствует в каждой строке вакансии.

### Ранги должности (seniority)

Фильтр `seniority_ranks` · поле ответа `seniority_rank`. Определяется по названию должности.

| Ранг | Уровень      | Охватывает                                                                                 |
| ---- | ------------ | ------------------------------------------------------------------------------------------ |
| `5`  | executive    | VP и выше, владельцы, основатели, партнёры, C-suite                                        |
| `4`  | director     | Director и роли head-of ниже VP                                                            |
| `3`  | manager      | Manager                                                                                    |
| `2`  | senior       | Senior индивидуальный участник                                                             |
| `1`  | junior       | Entry, intern и другие индивидуальные участники                                            |
| `0`  | unclassified | Только в ответе — должность не удалось классифицировать. Недопустимо как значение фильтра. |

Значение вне диапазона `1`–`5` игнорируется, и фильтр отбрасывается, поэтому `[7]` вернёт всё.

### Функции работы

Фильтр `functions` · поле ответа `functions` (массив, `null`, если не классифицировано). Один и тот же слаг может встречаться у многих должностей; одна должность может нести несколько слагов. Совпадает с любым указанным слагом; нераспознанный слаг не совпадает ни с чем.

Наиболее распространённые слаги, в порядке убывания количества вакансий:

| Слаг                       | Слаг                    | Слаг                          |
| -------------------------- | ----------------------- | ----------------------------- |
| `engineering`              | `sales`                 | `entrepreneurship`            |
| `human_resources`          | `operations`            | `marketing`                   |
| `consulting`               | `business_development`  | `information_technology`      |
| `education`                | `finance`               | `support`                     |
| `administrative`           | `arts_and_design`       | `media_and_commmunication`    |
| `legal`                    | `accounting`            | `data_science`                |
| `product_management`       | `engineering_technical` | `teacher`                     |
| `customer_service_support` | `software_development`  | `office_operations`           |
| `lawyer_attorney`          | `all_design`            | `project_management`          |
| `nursing`                  | `logistics`             | `financial_planning_analysis` |
| `content_marketing`        | `graphic_design`        | `executive`                   |
| `it_operations`            | `talent_management`     | `research_development`        |
| `financial_reporting`      | `quality_assurance`     | `construction`                |
| `medicine`                 | `customer_experience`   | `psychology`                  |

<Note>
  `media_and_commmunication` в данных написано с тремя буквами `m`. Копируйте как есть.
</Note>

Длинный хвост (ещё несколько сотен слагов, таких как `information_security`, `supply_chain`, `devops`) использует тот же словарь, что и колонка `slug` в [Department Functions](/ru/api-reference/endpoint/departments/function). Быстрее всего найти слаги для узкой ниши — запустить поиск без фильтров по нескольким релевантным компаниям и посмотреть массив `functions` в строках результата.

### Типы источников вакансий

Поле ответа `source_type`. `linkedin` для подавляющего большинства вакансий; партнёрские job-борды указывают собственный слаг (`wantedly`, `tw1111`, `rocketpunch`). В более старых записях может быть `null`.

***

## Поиск объявлений

Используется в [Поиске объявлений](/ru/api-reference/endpoint/companies/advertisements_search), [Insights по объявлениям](/ru/api-reference/endpoint/companies/advertisements_insights) и в фильтрах `advertisement_*` на [Поиске компаний](/ru/api-reference/endpoint/companies/search).

### Типы источников

Фильтры `source_types` / `exclude_source_types` · поле ответа `source_type` · `advertisement_platforms` в Поиске компаний.

`linkedin` · `facebook` · `google` · `tiktok` · `apple`

`meta` принимается как псевдоним `facebook`. `facebook` охватывает все поверхности Meta; сузьте выборку с помощью `publisher_platforms`.

### Форматы

Фильтр `advertisement_formats` · поле ответа `advertisement_format_normalized`. Исходная метка, публикуемая источником, сохраняется в `advertisement_format`.

| Канонический слаг | Исходные метки, которые он охватывает                             |
| ----------------- | ----------------------------------------------------------------- |
| `image`           | `image`, `IMAGE`, `Single Image Ad`                               |
| `video`           | `video`, `VIDEO`, `Video Ad`, `MULTI_VIDEOS`, `Premiere Video Ad` |
| `text`            | `text`, `TEXT`, `Text Ad`                                         |
| `carousel`        | `CAROUSEL`, `MULTI_IMAGES`, `MULTI_MEDIAS`, `DCO`, `Carousel Ad`  |
| `dynamic_product` | `DPA`                                                             |
| `document`        | `Document Ad`                                                     |
| `message`         | `Message Ad`                                                      |
| `event`           | `EVENT`, `Event Ad`                                               |
| `article`         | `LinkedIn Article Ad`                                             |
| `spotlight`       | `Spotlight Ad`                                                    |
| `follow`          | `Follow Company Ad`                                               |
| `job`             | `Job Ad`                                                          |
| `engagement`      | `PAGE_LIKE`                                                       |
| `other`           | Только в ответе — исходная метка отсутствует в этой таблице       |

### Платформы публикации

Фильтры `publisher_platforms` / `exclude_publisher_platforms` · поле ответа `publisher_platforms`. Только поверхности Meta; `null` для всех остальных источников. Не чувствителен к регистру на входе, в нижнем регистре в ответах.

`facebook` · `instagram` · `messenger` · `threads` · `audience_network`

### Уровни охвата

Фильтр `reach_tiers` · каталог `reach_tiers[]` в Insights по объявлениям. Определяется по **нижней границе** диапазона показов источника, поэтому объявление с диапазоном `10k-50k` попадает в `10k_50k`. Объявления без оценки показов ни под один уровень не подпадают.

| Слаг        | Показы           |
| ----------- | ---------------- |
| `lt_1k`     | \< 1 тыс.        |
| `1k_10k`    | 1–10 тыс.        |
| `10k_50k`   | 10–50 тыс.       |
| `50k_100k`  | 50–100 тыс.      |
| `100k_500k` | 100–500 тыс.     |
| `500k_1m`   | 500 тыс. – 1 млн |
| `1m_plus`   | 1 млн+           |

### Статус объявлений

Фильтр `advertisement_status` в Поиске компаний.

| Слаг                 | Значение                                                                                                                                    |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `currently_running`  | Компании с зафиксированной рекламной активностью. Для всё ещё активных объявлений используйте фильтр `advertisement_running_ads: [1, null]` |
| `active_last_30_min` | Записи об объявлениях компании изменились за последние 30 минут — полезно для опроса (polling)                                              |

### Социальные сети

Фильтр `social_media` в Поиске компаний. По умолчанию — OR.

`linkedin` · `facebook` · `instagram` · `tiktok` · `twitter` · `x` · `github` · `wantedly` · `rocketpunch`

### Активность по странам

`advertisement_country_activity` принимает один объект: `{ "country": "US", "rank": [null, 500] }` или `{ "country": "US", "percentile": [90, null] }`. Ранг `1` — крупнейший рекламодатель в этой стране. См. [Фильтры рекламной активности](/ru/developer-guides/filters/overview#advertising-activity-filters).

***

## Поиск новостей

Используется в [Поиске новостей](/ru/api-reference/endpoint/companies/news_search) и [Insights по новостям](/ru/api-reference/endpoint/companies/news_insights).

| Фильтр                                | Словарь                                                                                  | Откуда получить                                                        |
| ------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `categories`                          | Слаги категорий, такие как `acquires`, `partners_with`, `receives_financing`, `launches` | [News Categories](/ru/api-reference/endpoint/news/categories) — `slug` |
| `news_galleries` / `news_gallery_ids` | Слаг или UUID галереи                                                                    | [News Galleries](/ru/api-reference/endpoint/news/galleries)            |
| `news_languages`                      | Коды ISO 639-1 (`en`, `ja`, `ko`, `zh`, …)                                               | [News Languages](/ru/api-reference/endpoint/news/languages)            |
| `locations` / `company_locations`     | Коды стран                                                                               | [Locations](/ru/api-reference/endpoint/locations/locations)            |

### Перечисления сигналов экспансии

Применяются только при `is_expansion_signal_available: true`.

| Поле                           | Значения                                                                                                                                |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| `expansion_signal_types`       | `AD` `AUDIENCE` `DNS` `ENTITY` `EVENT` `EVENT_PLUS` `EXEC` `HIRE` `INFRA` `IP` `NEWS` `OFFICE` `PARTNER` `PRODUCT` `REG` `SCALE` `TECH` |
| `expansion_signal_polarities`  | `expansion` `contraction_leading` `contraction_confirming` `contraction_lagging`                                                        |
| `signal_strength_slug` (ответ) | `low` `medium` `high` `very_high`                                                                                                       |

Полный словарь по экспансии — стадии, свежесть, динамика — на странице [Expansion Filters](/ru/api-reference/endpoint/expansions/types).

***

## Поиск людей

### Уровни менеджмента

Фильтр `management_levels`. Неизвестный слаг отбрасывается, если присутствуют другие фильтры по людям; если это единственный фильтр по людям, запрос завершается ошибкой `40037 Parameter(s) incorrect`.

`c_suite` · `director` · `entry` · `founder` · `head` · `intern` · `manager` · `owner` · `partner` · `senior` · `vp`

Обратите внимание: слаг для C-suite — это `c_suite`, а не `c_level`. Названия на вашем языке можно получить на странице [Management Levels](/ru/api-reference/endpoint/management-levels/management-levels).

### Отделы и функции

| Фильтр                 | Словарь                                                                   | Откуда получить                                                         |
| ---------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `departments`          | Слаги `master_*`, например `master_engineering_technical`, `master_sales` | [Departments](/ru/api-reference/endpoint/departments/departments)       |
| `department_functions` | Слаги функций, например `software_development`, `account_management`      | [Department Functions](/ru/api-reference/endpoint/departments/function) |

***

## Поиск компаний

| Фильтр                                                        | Словарь                           | Откуда получить                                                                      |
| ------------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------ |
| `verticals`, `vertical_categories`, `vertical_sub_categories` | Слаги вертикалей                  | [Verticals](/ru/api-reference/endpoint/verticals/verticals) и её эндпоинты категорий |
| `technologies`                                                | Слаги технологий                  | [Technologies](/ru/api-reference/endpoint/technologies/technologies)                 |
| `employees`                                                   | Слаги диапазонов размера компании | [Company Size](/ru/api-reference/endpoint/company-size/company-size)                 |
| `locations`, `exclude_locations`                              | Коды стран                        | [Locations](/ru/api-reference/endpoint/locations/locations)                          |

***

## Константы, используемые только в ответах

| Поле                                     | Значения                         | Значение                                                                   |
| ---------------------------------------- | -------------------------------- | -------------------------------------------------------------------------- |
| `metadata.coverage_notes[].scope`        | `eea_uk_ch`                      | Примечание о покрытии для запрошенного источника                           |
| `metadata.skipped_source_types[].reason` | `country_unknown_until_enriched` | Источник не был применён для запрошенных `target_locations`                |
| `pagination.is_timeout`                  | `true` / `false`                 | Запрос подсчёта превысил таймаут; `total_entries` — приблизительная оценка |
| `metadata.ignored_fields`                | Массив ключей запроса            | Ключи, которые эндпоинт отбросил, так как не распознаёт их                 |

## Смотрите также

<CardGroup cols={2}>
  <Card title="Обзор фильтров" icon="filter" href="/ru/developer-guides/filters/overview">
    Как массивы, AND/OR и `filter_conditions` сочетаются во всех эндпоинтах поиска.
  </Card>

  <Card title="Коды состояния" icon="triangle-exclamation" href="/ru/api-reference/status-codes">
    Полная таблица кодов ошибок.
  </Card>
</CardGroup>