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

# Enums & Constants

> Every fixed value the Pubrio API accepts or returns — seniority ranks, job functions, ad sources and formats, reach tiers, signal types, management levels — on one page.

Most Pubrio filters take a **slug** from a closed list. Short lists are printed here in full. Long, changing lists (countries, technologies, verticals, news categories) come from the endpoints under the **Filters** group, and this page tells you which one.

<Warning>
  Most search filters **do not reject** an unknown value. Some drop the filter and return everything (`seniority_ranks`), others apply it and return nothing (`functions`, `source_types`, `reach_tiers`). Both look like a normal `200`. Always check `metadata.ignored_fields` and, on advertisement search, `metadata.unsupported_source_types`.
</Warning>

## Conventions

| Shape                                                        | Meaning                                                                                                                                                                                       | Example                        |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `["YYYY-MM-DD", "YYYY-MM-DD"]`                               | Inclusive date window `[from, to]`. Day boundaries follow your workspace timezone, except `launch_dates` and `active_dates`, which use UTC. Where noted, a single element means that one day. | `["2026-08-01", "2026-08-31"]` |
| Date or ISO timestamp (scalar: `created_at`, `published_at`) | At or after this instant, compared in UTC.                                                                                                                                                    | `"2026-09-02T12:00:00Z"`       |
| `[min, max]` with `null`                                     | Numeric range; `null` leaves that side open.                                                                                                                                                  | `[1, null]` = at least one     |
| Arrays of slugs                                              | Match **any** listed value (OR) unless you promote the key to AND with [`filter_conditions`](/en/developer-guides/filters/filter-conditions).                                                 | `["linkedin", "facebook"]`     |
| Country codes                                                | ISO 3166-1 alpha-2, upper-case. Full list from [Locations](/en/api-reference/endpoint/locations/locations).                                                                                   | `"US"`, `"SG"`                 |

***

## Job Search

Used by [Job Search](/en/api-reference/endpoint/companies/job_search) and echoed on every job row.

### Seniority ranks

`seniority_ranks` filter · `seniority_rank` response field. Resolved from the job title.

| Rank | Tier         | Covers                                                                       |
| ---- | ------------ | ---------------------------------------------------------------------------- |
| `5`  | executive    | VP and above, owners, founders, partners, C-suite                            |
| `4`  | director     | Director and head-of roles below VP                                          |
| `3`  | manager      | Manager                                                                      |
| `2`  | senior       | Senior individual contributor                                                |
| `1`  | junior       | Entry, intern and other individual contributors                              |
| `0`  | unclassified | Response only — the title could not be classified. Not a valid filter value. |

A value outside `1`–`5` is ignored and the filter is dropped, so `[7]` returns everything.

### Job functions

`functions` filter · `functions` response field (array, `null` when unclassified). The same slug can appear on many titles; a title can carry several slugs. Matches any listed slug; an unrecognised slug matches nothing.

The most common slugs, in descending order of postings:

| 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` is spelled with three `m`s in the data. Copy it as written.
</Note>

The long tail (several hundred further slugs such as `information_security`, `supply_chain`, `devops`) uses the same vocabulary as the `slug` column of [Department Functions](/en/api-reference/endpoint/departments/function). The quickest way to discover slugs for a niche is to run an unfiltered search on a few relevant companies and read the `functions` array on the rows.

### Job source types

`source_type` response field. `linkedin` for the large majority of postings; partner job boards report their own slug (`wantedly`, `tw1111`, `rocketpunch`). Older rows can be `null`.

***

## Advertisement Search

Used by [Advertisement Search](/en/api-reference/endpoint/companies/advertisements_search), [Advertisement Insights](/en/api-reference/endpoint/companies/advertisements_insights) and the `advertisement_*` filters on [Company Search](/en/api-reference/endpoint/companies/search).

### Source types

`source_types` / `exclude_source_types` filters · `source_type` response field · `advertisement_platforms` on Company Search.

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

`meta` is accepted as an alias of `facebook`. `facebook` spans every Meta surface; narrow it with `publisher_platforms`.

### Formats

`advertisement_formats` filter · `advertisement_format_normalized` response field. The raw label the source publishes is kept in `advertisement_format`.

| Canonical slug    | Raw labels it covers                                              |
| ----------------- | ----------------------------------------------------------------- |
| `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`           | Response only — a raw label not in this map                       |

### Publisher platforms

`publisher_platforms` / `exclude_publisher_platforms` filters · `publisher_platforms` response field. Meta surfaces only; `null` on every other source. Case-insensitive on input, lower-case in responses.

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

### Reach tiers

`reach_tiers` filter · `reach_tiers[]` catalog on Advertisement Insights. Derived from the **lower bound** of the source's impression range, so a `10k-50k` ad sits in `10k_50k`. Ads with no impression estimate never match a tier.

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

`advertisement_status` filter on Company Search.

| Slug                 | Meaning                                                                                                               |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `currently_running`  | Companies with advertising on record. For ads that are still live, filter with `advertisement_running_ads: [1, null]` |
| `active_last_30_min` | The company's ad records changed in the last 30 minutes — useful for polling                                          |

### Social media

`social_media` filter on Company Search. OR by default.

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

### Country activity

`advertisement_country_activity` takes one object: `{ "country": "US", "rank": [null, 500] }` or `{ "country": "US", "percentile": [90, null] }`. Rank `1` is the biggest advertiser in that country. See [Advertising activity filters](/en/developer-guides/filters/overview#advertising-activity-filters).

***

## News Search

Used by [News Search](/en/api-reference/endpoint/companies/news_search) and [News Insights](/en/api-reference/endpoint/companies/news_insights).

| Filter                                | Vocabulary                                                                           | Where to fetch it                                                      |
| ------------------------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
| `categories`                          | Category slugs such as `acquires`, `partners_with`, `receives_financing`, `launches` | [News Categories](/en/api-reference/endpoint/news/categories) — `slug` |
| `news_galleries` / `news_gallery_ids` | Gallery slug or UUID                                                                 | [News Galleries](/en/api-reference/endpoint/news/galleries)            |
| `news_languages`                      | ISO 639-1 codes (`en`, `ja`, `ko`, `zh`, …)                                          | [News Languages](/en/api-reference/endpoint/news/languages)            |
| `locations` / `company_locations`     | Country codes                                                                        | [Locations](/en/api-reference/endpoint/locations/locations)            |

### Expansion signal enums

Only applied when `is_expansion_signal_available: true`.

| Field                             | Values                                                                                                                                  |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `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` (response) | `low` `medium` `high` `very_high`                                                                                                       |

The full expansion vocabulary — stages, freshness, momentum — is on [Expansion Filters](/en/api-reference/endpoint/expansions/types).

***

## People Search

### Management levels

`management_levels` filter. An unknown slug is dropped when other people filters are present; when it is the only people filter the request fails with `40037 Parameter(s) incorrect`.

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

Note the C-suite slug is `c_suite`, not `c_level`. Fetch names in your language from [Management Levels](/en/api-reference/endpoint/management-levels/management-levels).

### Departments and functions

| Filter                 | Vocabulary                                                            | Where to fetch it                                                       |
| ---------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `departments`          | `master_*` slugs, e.g. `master_engineering_technical`, `master_sales` | [Departments](/en/api-reference/endpoint/departments/departments)       |
| `department_functions` | Function slugs, e.g. `software_development`, `account_management`     | [Department Functions](/en/api-reference/endpoint/departments/function) |

***

## Company Search

| Filter                                                        | Vocabulary              | Where to fetch it                                                                      |
| ------------------------------------------------------------- | ----------------------- | -------------------------------------------------------------------------------------- |
| `verticals`, `vertical_categories`, `vertical_sub_categories` | Vertical slugs          | [Verticals](/en/api-reference/endpoint/verticals/verticals) and its category endpoints |
| `technologies`                                                | Technology slugs        | [Technologies](/en/api-reference/endpoint/technologies/technologies)                   |
| `employees`                                                   | Company-size band slugs | [Company Size](/en/api-reference/endpoint/company-size/company-size)                   |
| `locations`, `exclude_locations`                              | Country codes           | [Locations](/en/api-reference/endpoint/locations/locations)                            |

***

## Response-only constants

| Field                                    | Values                           | Meaning                                                          |
| ---------------------------------------- | -------------------------------- | ---------------------------------------------------------------- |
| `metadata.coverage_notes[].scope`        | `eea_uk_ch`                      | Coverage note for a requested source                             |
| `metadata.skipped_source_types[].reason` | `country_unknown_until_enriched` | The source was not applied for the requested `target_locations`  |
| `pagination.is_timeout`                  | `true` / `false`                 | The count query timed out; `total_entries` is a partial estimate |
| `metadata.ignored_fields`                | Array of request keys            | Keys the endpoint dropped because it does not recognise them     |

## Related

<CardGroup cols={2}>
  <Card title="Filters overview" icon="filter" href="/en/developer-guides/filters/overview">
    How arrays, AND/OR and `filter_conditions` combine across every search endpoint.
  </Card>

  <Card title="Status codes" icon="triangle-exclamation" href="/en/api-reference/status-codes">
    The full error-code table.
  </Card>
</CardGroup>