> ## 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 필터는 닫힌 목록의 **슬러그**를 받습니다. 짧은 목록은 이 페이지에 전부 실려 있습니다. 길고 변하는 목록(국가, 기술, 버티컬, 뉴스 카테고리)은 **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 이상             |
| 슬러그 배열                                             | [`filter_conditions`](/ko/developer-guides/filters/filter-conditions)로 키를 AND로 승격하지 않는 한, 나열한 값 **중 하나**와 일치(OR).       | `["linkedin", "facebook"]`     |
| 국가 코드                                              | ISO 3166-1 alpha-2, 대문자. 전체 목록은 [Locations](/ko/api-reference/endpoint/locations/locations).                            | `"US"`, `"SG"`                 |

***

## 채용 공고 검색

[채용 공고 검색](/ko/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`). 같은 슬러그가 여러 직책에 나타날 수 있고, 한 직책이 여러 슬러그를 가질 수 있습니다. 나열한 슬러그 중 하나와 일치하며, 인식할 수 없는 슬러그는 아무것도 일치하지 않습니다.

공고 수 내림차순으로 가장 흔한 슬러그:

| 슬러그                        | 슬러그                     | 슬러그                           |
| -------------------------- | ----------------------- | ----------------------------- |
| `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` 등 수백 개의 슬러그)은 [부서 직무](/ko/api-reference/endpoint/departments/function)의 `slug` 열과 같은 어휘를 사용합니다. 틈새 슬러그를 찾는 가장 빠른 방법은 관련 회사 몇 곳에 필터 없이 검색한 뒤 각 행의 `functions` 배열을 읽는 것입니다.

### 채용 소스 유형

`source_type` 응답 필드. 대부분의 공고는 `linkedin`이며, 파트너 채용 사이트는 자체 슬러그(`wantedly`, `tw1111`, `rocketpunch`)를 보고합니다. 오래된 행은 `null`일 수 있습니다.

***

## 광고 검색

[광고 검색](/ko/api-reference/endpoint/companies/advertisements_search), [광고 인사이트](/ko/api-reference/endpoint/companies/advertisements_insights), 그리고 [회사 검색](/ko/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`에 보존됩니다.

| 정규 슬러그            | 포함되는 원본 레이블                                                       |
| ----------------- | ----------------------------------------------------------------- |
| `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`에 속합니다. 노출 추정치가 없는 광고는 어느 구간에도 일치하지 않습니다.

| 슬러그         | 노출 수        |
| ----------- | ----------- |
| `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` 필터.

| 슬러그                  | 의미                                                                        |
| -------------------- | ------------------------------------------------------------------------- |
| `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`은 해당 국가에서 가장 큰 광고주입니다. [광고 활동 필터](/ko/developer-guides/filters/overview#광고-활동-필터)를 참고하세요.

***

## 뉴스 검색

[뉴스 검색](/ko/api-reference/endpoint/companies/news_search)과 [뉴스 인사이트](/ko/api-reference/endpoint/companies/news_insights)에서 사용됩니다.

| 필터                                    | 어휘                                                                        | 가져오는 곳                                                         |
| ------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------- |
| `categories`                          | `acquires`, `partners_with`, `receives_financing`, `launches` 같은 카테고리 슬러그 | [뉴스 카테고리](/ko/api-reference/endpoint/news/categories) — `slug` |
| `news_galleries` / `news_gallery_ids` | 갤러리 슬러그 또는 UUID                                                           | [뉴스 갤러리](/ko/api-reference/endpoint/news/galleries)            |
| `news_languages`                      | ISO 639-1 코드(`en`, `ja`, `ko`, `zh` 등)                                    | [뉴스 언어](/ko/api-reference/endpoint/news/languages)             |
| `locations` / `company_locations`     | 국가 코드                                                                     | [Locations](/ko/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`                                                                                                       |

단계, 최신성, 모멘텀을 포함한 전체 확장 어휘는 [확장 필터](/ko/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_level`이 아니라 `c_suite`입니다. 사용 언어의 이름은 [관리 레벨](/ko/api-reference/endpoint/management-levels/management-levels)에서 가져오세요.

### 부서와 직무

| 필터                     | 어휘                                                               | 가져오는 곳                                                   |
| ---------------------- | ---------------------------------------------------------------- | -------------------------------------------------------- |
| `departments`          | `master_engineering_technical`, `master_sales` 같은 `master_*` 슬러그 | [부서](/ko/api-reference/endpoint/departments/departments) |
| `department_functions` | `software_development`, `account_management` 같은 직무 슬러그           | [부서 직무](/ko/api-reference/endpoint/departments/function) |

***

## 회사 검색

| 필터                                                            | 어휘           | 가져오는 곳                                                              |
| ------------------------------------------------------------- | ------------ | ------------------------------------------------------------------- |
| `verticals`, `vertical_categories`, `vertical_sub_categories` | 버티컬 슬러그      | [버티컬](/ko/api-reference/endpoint/verticals/verticals)과 그 카테고리 엔드포인트 |
| `technologies`                                                | 기술 슬러그       | [기술](/ko/api-reference/endpoint/technologies/technologies)          |
| `employees`                                                   | 회사 규모 구간 슬러그 | [회사 규모](/ko/api-reference/endpoint/company-size/company-size)       |
| `locations`, `exclude_locations`                              | 국가 코드        | [Locations](/ko/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="/ko/developer-guides/filters/overview">
    배열, AND/OR, `filter_conditions`가 모든 검색 엔드포인트에서 어떻게 결합되는지.
  </Card>

  <Card title="상태 코드" icon="triangle-exclamation" href="/ko/api-reference/status-codes">
    전체 오류 코드 표.
  </Card>
</CardGroup>
