> ## 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 筛选器接受来自封闭列表的 **slug**。简短的列表在此完整列出。较长且会变化的列表（国家、技术、垂直行业、新闻分类）由 **Filters** 分组下的端点提供，本页会告诉你该调用哪一个。

<Warning>
  大多数搜索筛选器**不会拒绝**未知值。有的会丢弃该筛选器并返回全部结果（`seniority_ranks`），有的会应用它并返回空结果（`functions`、`source_types`、`reach_tiers`）。两者看起来都是正常的 `200`。请始终检查 `metadata.ignored_fields`，在广告搜索中还要检查 `metadata.unsupported_source_types`。
</Warning>

## 约定

| 形式                                          | 含义                                                                                                     | 示例                             |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------ |
| `["YYYY-MM-DD", "YYYY-MM-DD"]`              | 闭区间日期窗口 `[from, to]`。日期边界遵循你的工作区时区，但 `launch_dates` 和 `active_dates` 使用 UTC。标注处只传一个元素表示当天。             | `["2026-08-01", "2026-08-31"]` |
| 日期或 ISO 时间戳（标量：`created_at`、`published_at`） | 该时刻当时或之后，按 UTC 比较。                                                                                     | `"2026-09-02T12:00:00Z"`       |
| 含 `null` 的 `[min, max]`                     | 数值范围；`null` 表示该侧不设限。                                                                                   | `[1, null]` = 至少 1             |
| slug 数组                                     | 匹配**任一**列出的值（OR），除非用 [`filter_conditions`](/cn/developer-guides/filters/filter-conditions) 把该键提升为 AND。 | `["linkedin", "facebook"]`     |
| 国家代码                                        | ISO 3166-1 alpha-2，大写。完整列表见 [Locations](/cn/api-reference/endpoint/locations/locations)。               | `"US"`、`"SG"`                  |

***

## 职位搜索

用于[职位搜索](/cn/api-reference/endpoint/companies/job_search)，并回显在每一行职位中。

### 职级层级

`seniority_ranks` 筛选器 · `seniority_rank` 响应字段。根据职位名称解析。

| 层级  | 名称                | 涵盖                          |
| --- | ----------------- | --------------------------- |
| `5` | executive（高管）     | VP 及以上、所有者、创始人、合伙人、C-suite  |
| `4` | director（总监）      | VP 以下的总监和负责人角色              |
| `3` | manager（经理）       | 经理                          |
| `2` | senior（资深）        | 资深个人贡献者                     |
| `1` | junior（初级）        | 入门、实习及其他个人贡献者               |
| `0` | unclassified（未分类） | 仅出现在响应中——职位名称无法分类。不是有效的筛选值。 |

`1`–`5` 以外的值会被忽略并丢弃该筛选器，因此 `[7]` 会返回全部结果。

### 职能

`functions` 筛选器 · `functions` 响应字段（数组，未分类时为 `null`）。同一 slug 可出现在多个职位上；一个职位可携带多个 slug。匹配任一列出的 slug；无法识别的 slug 不匹配任何结果。

按职位数量降序排列的最常见 slug：

| Slug                       | Slug                    | Slug                          |
| -------------------------- | ----------------------- | ----------------------------- |
| `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>

长尾部分（还有数百个 slug，如 `information_security`、`supply_chain`、`devops`）与[部门职能](/cn/api-reference/endpoint/departments/function)的 `slug` 列使用相同词表。发现小众 slug 最快的方式是对几家相关公司做一次不带筛选的搜索，然后读取各行的 `functions` 数组。

### 职位来源类型

`source_type` 响应字段。绝大多数职位为 `linkedin`；合作招聘网站报告各自的 slug（`wantedly`、`tw1111`、`rocketpunch`）。较早的行可能为 `null`。

***

## 广告搜索

用于[广告搜索](/cn/api-reference/endpoint/companies/advertisements_search)、[广告洞察](/cn/api-reference/endpoint/companies/advertisements_insights)以及[公司搜索](/cn/api-reference/endpoint/companies/search)上的 `advertisement_*` 筛选器。

### 来源类型

`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` 中。

| 规范 slug           | 涵盖的原始标签                                                       |
| ----------------- | ------------------------------------------------------------- |
| `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[]` 目录。取自来源曝光范围的**下限**，因此 `10k-50k` 的广告属于 `10k_50k`。没有曝光估算的广告不会匹配任何区间。

| Slug        | 曝光量         |
| ----------- | ----------- |
| `lt_1k`     | \< 1K       |
| `1k_10k`    | 1K – 10K    |
| `10k_50k`   | 10K – 50K   |
| `50k_100k`  | 50K – 100K  |
| `100k_500k` | 100K – 500K |
| `500k_1m`   | 500K – 1M   |
| `1m_plus`   | 1M+         |

### 广告状态

公司搜索上的 `advertisement_status` 筛选器。

| Slug                 | 含义                                                           |
| -------------------- | ------------------------------------------------------------ |
| `currently_running`  | 有广告记录的公司。仍在投放的广告请用 `advertisement_running_ads: [1, null]` 筛选 |
| `active_last_30_min` | 公司的广告记录在最近 30 分钟内有变化——适合轮询                                   |

### 社交媒体

公司搜索上的 `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` 是该国最大的广告主。见[广告活动筛选器](/cn/developer-guides/filters/overview#广告活动筛选器)。

***

## 新闻搜索

用于[新闻搜索](/cn/api-reference/endpoint/companies/news_search)和[新闻洞察](/cn/api-reference/endpoint/companies/news_insights)。

| 筛选器                                   | 词表                                                                   | 获取位置                                                        |
| ------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------- |
| `categories`                          | 分类 slug，如 `acquires`、`partners_with`、`receives_financing`、`launches` | [新闻分类](/cn/api-reference/endpoint/news/categories)——`slug`  |
| `news_galleries` / `news_gallery_ids` | 画廊 slug 或 UUID                                                       | [新闻画廊](/cn/api-reference/endpoint/news/galleries)           |
| `news_languages`                      | ISO 639-1 代码（`en`、`ja`、`ko`、`zh` 等）                                  | [新闻语言](/cn/api-reference/endpoint/news/languages)           |
| `locations` / `company_locations`     | 国家代码                                                                 | [Locations](/cn/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`                                                                                                       |

完整的扩张词表——阶段、新鲜度、动量——见[扩张筛选器](/cn/api-reference/endpoint/expansions/types)。

***

## 人员搜索

### 管理层级

`management_levels` 筛选器。存在其他人员筛选器时，未知 slug 会被丢弃；当它是唯一的人员筛选器时，请求会以 `40037 Parameter(s) incorrect` 失败。

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

注意 C-suite 的 slug 是 `c_suite`，而不是 `c_level`。可从[管理层级](/cn/api-reference/endpoint/management-levels/management-levels)获取你所用语言的名称。

### 部门与职能

| 筛选器                    | 词表                                                              | 获取位置                                                     |
| ---------------------- | --------------------------------------------------------------- | -------------------------------------------------------- |
| `departments`          | `master_*` slug，如 `master_engineering_technical`、`master_sales` | [部门](/cn/api-reference/endpoint/departments/departments) |
| `department_functions` | 职能 slug，如 `software_development`、`account_management`           | [部门职能](/cn/api-reference/endpoint/departments/function)  |

***

## 公司搜索

| 筛选器                                                         | 词表          | 获取位置                                                         |
| ----------------------------------------------------------- | ----------- | ------------------------------------------------------------ |
| `verticals`、`vertical_categories`、`vertical_sub_categories` | 垂直行业 slug   | [垂直行业](/cn/api-reference/endpoint/verticals/verticals)及其分类端点 |
| `technologies`                                              | 技术 slug     | [技术](/cn/api-reference/endpoint/technologies/technologies)   |
| `employees`                                                 | 公司规模区间 slug | [公司规模](/cn/api-reference/endpoint/company-size/company-size) |
| `locations`、`exclude_locations`                             | 国家代码        | [Locations](/cn/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="/cn/developer-guides/filters/overview">
    数组、AND/OR 与 `filter_conditions` 在所有搜索端点上如何组合。
  </Card>

  <Card title="状态码" icon="triangle-exclamation" href="/cn/api-reference/status-codes">
    完整的错误码表。
  </Card>
</CardGroup>