> ## 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 e constantes

> Todos os valores fixos que a API Pubrio aceita ou retorna — níveis de senioridade, funções de cargo, fontes e formatos de anúncios, faixas de alcance, tipos de sinal, níveis de gestão — em uma única página.

A maioria dos filtros da Pubrio recebe um **slug** de uma lista fechada. Listas curtas são impressas aqui na íntegra. Listas longas e sujeitas a mudança (países, tecnologias, verticais, categorias de notícias) vêm dos endpoints do grupo **Filters**, e esta página indica qual usar.

<Warning>
  A maioria dos filtros de busca **não rejeita** um valor desconhecido. Alguns descartam o filtro e retornam tudo (`seniority_ranks`), outros aplicam o filtro e retornam nada (`functions`, `source_types`, `reach_tiers`). Ambos os casos parecem um `200` normal. Sempre verifique `metadata.ignored_fields` e, na busca de anúncios, `metadata.unsupported_source_types`.
</Warning>

## Convenções

| Formato                                                       | Significado                                                                                                                                                                                                                | Exemplo                        |
| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `["YYYY-MM-DD", "YYYY-MM-DD"]`                                | Janela de datas inclusiva `[from, to]`. Os limites de dia seguem o fuso horário do seu workspace, exceto `launch_dates` e `active_dates`, que usam UTC. Onde indicado, um único elemento representa aquele dia específico. | `["2026-08-01", "2026-08-31"]` |
| Data ou timestamp ISO (escalar: `created_at`, `published_at`) | Neste instante ou depois, comparado em UTC.                                                                                                                                                                                | `"2026-09-02T12:00:00Z"`       |
| `[min, max]` com `null`                                       | Faixa numérica; `null` deixa aquele lado aberto.                                                                                                                                                                           | `[1, null]` = ao menos 1       |
| Arrays de slugs                                               | Corresponde a **qualquer** valor listado (OR), a menos que você eleve a chave para AND com [`filter_conditions`](/pt/developer-guides/filters/filter-conditions).                                                          | `["linkedin", "facebook"]`     |
| Códigos de país                                               | ISO 3166-1 alpha-2, em maiúsculas. Lista completa em [Locations](/pt/api-reference/endpoint/locations/locations).                                                                                                          | `"US"`, `"SG"`                 |

***

## Busca de vagas

Usado por [Job Search](/pt/api-reference/endpoint/companies/job_search) e reproduzido em cada linha de vaga.

### Níveis de senioridade

Filtro `seniority_ranks` · campo de resposta `seniority_rank`. Resolvido a partir do título da vaga.

| Nível | Camada       | Abrange                                                                                |
| ----- | ------------ | -------------------------------------------------------------------------------------- |
| `5`   | executive    | VP e acima, proprietários, fundadores, sócios, C-suite                                 |
| `4`   | director     | Diretores e cargos de head abaixo de VP                                                |
| `3`   | manager      | Gerente                                                                                |
| `2`   | senior       | Contribuidor individual sênior                                                         |
| `1`   | junior       | Entrada, estágio e outros contribuidores individuais                                   |
| `0`   | unclassified | Apenas resposta — o título não pôde ser classificado. Não é um valor de filtro válido. |

Um valor fora de `1`–`5` é ignorado e o filtro é descartado, então `[7]` retorna tudo.

### Funções de cargo

Filtro `functions` · campo de resposta `functions` (array, `null` quando não classificado). O mesmo slug pode aparecer em vários títulos; um título pode carregar vários slugs. Corresponde a qualquer slug listado; um slug não reconhecido não corresponde a nada.

Os slugs mais comuns, em ordem decrescente de vagas:

| 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` é grafado com três `m` nos dados. Copie exatamente como está.
</Note>

A cauda longa (várias centenas de outros slugs, como `information_security`, `supply_chain`, `devops`) usa o mesmo vocabulário da coluna `slug` de [Department Functions](/pt/api-reference/endpoint/departments/function). A forma mais rápida de descobrir slugs de um nicho é rodar uma busca sem filtros em algumas empresas relevantes e ler o array `functions` das linhas retornadas.

### Tipos de fonte de vaga

Campo de resposta `source_type`. `linkedin` para a grande maioria das vagas; quadros de vagas parceiros reportam seu próprio slug (`wantedly`, `tw1111`, `rocketpunch`). Registros mais antigos podem ser `null`.

***

## Busca de anúncios

Usado por [Advertisement Search](/pt/api-reference/endpoint/companies/advertisements_search), [Advertisement Insights](/pt/api-reference/endpoint/companies/advertisements_insights) e pelos filtros `advertisement_*` em [Company Search](/pt/api-reference/endpoint/companies/search).

### Tipos de fonte

Filtros `source_types` / `exclude_source_types` · campo de resposta `source_type` · `advertisement_platforms` na Company Search.

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

`meta` é aceito como um alias de `facebook`. `facebook` abrange todas as superfícies da Meta; use `publisher_platforms` para restringir.

### Formatos

Filtro `advertisement_formats` · campo de resposta `advertisement_format_normalized`. O rótulo bruto publicado pela fonte fica em `advertisement_format`.

| Slug canônico     | Rótulos brutos que abrange                                        |
| ----------------- | ----------------------------------------------------------------- |
| `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`           | Apenas resposta — um rótulo bruto que não está neste mapa         |

### Plataformas de publicação

Filtros `publisher_platforms` / `exclude_publisher_platforms` · campo de resposta `publisher_platforms`. Apenas superfícies Meta; `null` em qualquer outra fonte. Não diferencia maiúsculas/minúsculas na entrada, minúsculas nas respostas.

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

### Faixas de alcance

Filtro `reach_tiers` · catálogo `reach_tiers[]` no Advertisement Insights. Derivado do **limite inferior** da faixa de impressões da fonte, então um anúncio `10k-50k` fica em `10k_50k`. Anúncios sem estimativa de impressões nunca correspondem a nenhuma faixa.

| Slug        | Impressões  |
| ----------- | ----------- |
| `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+         |

### Status do anúncio

Filtro `advertisement_status` na Company Search.

| Slug                 | Significado                                                                                                      |
| -------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `currently_running`  | Empresas com anúncios registrados. Para anúncios ainda ativos, filtre com `advertisement_running_ads: [1, null]` |
| `active_last_30_min` | Os registros de anúncios da empresa mudaram nos últimos 30 minutos — útil para polling                           |

### Redes sociais

Filtro `social_media` na Company Search. OR por padrão.

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

### Atividade por país

`advertisement_country_activity` recebe um objeto: `{ "country": "US", "rank": [null, 500] }` ou `{ "country": "US", "percentile": [90, null] }`. O rank `1` é o maior anunciante naquele país. Veja [Filtros de atividade publicitária](/pt/developer-guides/filters/overview#advertising-activity-filters).

***

## Busca de notícias

Usado por [News Search](/pt/api-reference/endpoint/companies/news_search) e [News Insights](/pt/api-reference/endpoint/companies/news_insights).

| Filtro                                | Vocabulário                                                                           | Onde buscar                                                            |
| ------------------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `categories`                          | Slugs de categoria como `acquires`, `partners_with`, `receives_financing`, `launches` | [News Categories](/pt/api-reference/endpoint/news/categories) — `slug` |
| `news_galleries` / `news_gallery_ids` | Slug ou UUID da galeria                                                               | [News Galleries](/pt/api-reference/endpoint/news/galleries)            |
| `news_languages`                      | Códigos ISO 639-1 (`en`, `ja`, `ko`, `zh`, …)                                         | [News Languages](/pt/api-reference/endpoint/news/languages)            |
| `locations` / `company_locations`     | Códigos de país                                                                       | [Locations](/pt/api-reference/endpoint/locations/locations)            |

### Enums de sinais de expansão

Aplicados somente quando `is_expansion_signal_available: true`.

| Campo                             | Valores                                                                                                                                 |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `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` (resposta) | `low` `medium` `high` `very_high`                                                                                                       |

O vocabulário completo de expansão — estágios, atualidade, momentum — está em [Expansion Filters](/pt/api-reference/endpoint/expansions/types).

***

## Busca de pessoas

### Níveis de gestão

Filtro `management_levels`. Um slug desconhecido é descartado quando há outros filtros de pessoas presentes; quando é o único filtro de pessoas, a requisição falha com `40037 Parameter(s) incorrect`.

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

Observe que o slug do C-suite é `c_suite`, não `c_level`. Busque os nomes no seu idioma em [Management Levels](/pt/api-reference/endpoint/management-levels/management-levels).

### Departamentos e funções

| Filtro                 | Vocabulário                                                           | Onde buscar                                                             |
| ---------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `departments`          | Slugs `master_*`, ex.: `master_engineering_technical`, `master_sales` | [Departments](/pt/api-reference/endpoint/departments/departments)       |
| `department_functions` | Slugs de função, ex.: `software_development`, `account_management`    | [Department Functions](/pt/api-reference/endpoint/departments/function) |

***

## Busca de empresas

| Filtro                                                        | Vocabulário                          | Onde buscar                                                                               |
| ------------------------------------------------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------- |
| `verticals`, `vertical_categories`, `vertical_sub_categories` | Slugs de vertical                    | [Verticals](/pt/api-reference/endpoint/verticals/verticals) e seus endpoints de categoria |
| `technologies`                                                | Slugs de tecnologia                  | [Technologies](/pt/api-reference/endpoint/technologies/technologies)                      |
| `employees`                                                   | Slugs de faixa de tamanho de empresa | [Company Size](/pt/api-reference/endpoint/company-size/company-size)                      |
| `locations`, `exclude_locations`                              | Códigos de país                      | [Locations](/pt/api-reference/endpoint/locations/locations)                               |

***

## Constantes apenas de resposta

| Campo                                    | Valores                          | Significado                                                                             |
| ---------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------- |
| `metadata.coverage_notes[].scope`        | `eea_uk_ch`                      | Nota de cobertura para uma fonte solicitada                                             |
| `metadata.skipped_source_types[].reason` | `country_unknown_until_enriched` | A fonte não foi aplicada para os `target_locations` solicitados                         |
| `pagination.is_timeout`                  | `true` / `false`                 | A consulta de contagem excedeu o tempo limite; `total_entries` é uma estimativa parcial |
| `metadata.ignored_fields`                | Array de chaves da requisição    | Chaves que o endpoint descartou por não reconhecer                                      |

## Relacionados

<CardGroup cols={2}>
  <Card title="Visão geral de filtros" icon="filter" href="/pt/developer-guides/filters/overview">
    Como arrays, AND/OR e `filter_conditions` se combinam em todos os endpoints de busca.
  </Card>

  <Card title="Códigos de status" icon="triangle-exclamation" href="/pt/api-reference/status-codes">
    A tabela completa de códigos de erro.
  </Card>
</CardGroup>