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

# Enumeraciones y constantes

> Todos los valores fijos que la API de Pubrio acepta o devuelve — niveles de seniority, funciones de empleo, fuentes y formatos de anuncios, niveles de alcance, tipos de señal, niveles de gestión — en una sola página.

La mayoría de los filtros de Pubrio toman un **slug** de una lista cerrada. Las listas cortas se muestran aquí en su totalidad. Las listas largas y cambiantes (países, tecnologías, verticales, categorías de noticias) provienen de los endpoints del grupo **Filters**, y esta página te indica cuál usar en cada caso.

<Warning>
  La mayoría de los filtros de búsqueda **no rechazan** un valor desconocido. Algunos descartan el filtro y devuelven todo (`seniority_ranks`), otros lo aplican y no devuelven nada (`functions`, `source_types`, `reach_tiers`). Ambos casos parecen una respuesta `200` normal. Revisa siempre `metadata.ignored_fields` y, en la búsqueda de anuncios, `metadata.unsupported_source_types`.
</Warning>

## Convenciones

| Forma                                                         | Significado                                                                                                                                                                                                         | Ejemplo                        |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `["YYYY-MM-DD", "YYYY-MM-DD"]`                                | Ventana de fechas inclusiva `[from, to]`. Los límites del día siguen la zona horaria de tu workspace, excepto `launch_dates` y `active_dates`, que usan UTC. Donde se indique, un solo elemento representa ese día. | `["2026-08-01", "2026-08-31"]` |
| Fecha o timestamp ISO (escalar: `created_at`, `published_at`) | En o después de este instante, comparado en UTC.                                                                                                                                                                    | `"2026-09-02T12:00:00Z"`       |
| `[min, max]` con `null`                                       | Rango numérico; `null` deja ese extremo abierto.                                                                                                                                                                    | `[1, null]` = al menos uno     |
| Arrays de slugs                                               | Coincide con **cualquiera** de los valores listados (OR), salvo que promuevas la clave a AND con [`filter_conditions`](/es/developer-guides/filters/filter-conditions).                                             | `["linkedin", "facebook"]`     |
| Códigos de país                                               | ISO 3166-1 alfa-2, en mayúsculas. Lista completa en [Locations](/es/api-reference/endpoint/locations/locations).                                                                                                    | `"US"`, `"SG"`                 |

***

## Job Search

Usado por [Job Search](/es/api-reference/endpoint/companies/job_search) y devuelto en cada fila de empleo.

### Niveles de seniority

Filtro `seniority_ranks` · campo de respuesta `seniority_rank`. Se resuelve a partir del título del puesto.

| Rango | Nivel        | Comprende                                                                                |
| ----- | ------------ | ---------------------------------------------------------------------------------------- |
| `5`   | executive    | VP y superior, propietarios, fundadores, socios, C-suite                                 |
| `4`   | director     | Director y roles "head of" por debajo de VP                                              |
| `3`   | manager      | Manager                                                                                  |
| `2`   | senior       | Colaborador individual senior                                                            |
| `1`   | junior       | Nivel inicial, becarios y otros colaboradores individuales                               |
| `0`   | unclassified | Solo en la respuesta — el título no se pudo clasificar. No es un valor de filtro válido. |

Un valor fuera del rango `1`–`5` se ignora y el filtro se descarta, por lo que `[7]` devuelve todo.

### Funciones del empleo

Filtro `functions` · campo de respuesta `functions` (array, `null` cuando no está clasificado). El mismo slug puede aparecer en muchos títulos; un título puede tener varios slugs. Coincide con cualquier slug listado; un slug no reconocido no coincide con nada.

Los slugs más comunes, en orden descendente de cantidad de publicaciones:

| 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` se escribe con tres `m` en los datos. Cópialo tal como está.
</Note>

La cola larga (varios cientos de slugs adicionales como `information_security`, `supply_chain`, `devops`) usa el mismo vocabulario que la columna `slug` de [Department Functions](/es/api-reference/endpoint/departments/function). La forma más rápida de descubrir los slugs de un nicho es ejecutar una búsqueda sin filtros sobre algunas empresas relevantes y leer el array `functions` de las filas.

### Tipos de fuente del empleo

Campo de respuesta `source_type`. `linkedin` para la gran mayoría de las publicaciones; los portales de empleo asociados reportan su propio slug (`wantedly`, `tw1111`, `rocketpunch`). Las filas más antiguas pueden tener `null`.

***

## Advertisement Search

Usado por [Advertisement Search](/es/api-reference/endpoint/companies/advertisements_search), [Advertisement Insights](/es/api-reference/endpoint/companies/advertisements_insights) y los filtros `advertisement_*` de [Company Search](/es/api-reference/endpoint/companies/search).

### Tipos de fuente

Filtros `source_types` / `exclude_source_types` · campo de respuesta `source_type` · `advertisement_platforms` en Company Search.

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

`meta` se acepta como alias de `facebook`. `facebook` abarca todas las superficies de Meta; puedes acotarlo con `publisher_platforms`.

### Formatos

Filtro `advertisement_formats` · campo de respuesta `advertisement_format_normalized`. La etiqueta original que publica la fuente se conserva en `advertisement_format`.

| Slug canónico     | Etiquetas originales que cubre                                        |
| ----------------- | --------------------------------------------------------------------- |
| `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`           | Solo en la respuesta — una etiqueta original que no está en este mapa |

### Plataformas de publicación

Filtros `publisher_platforms` / `exclude_publisher_platforms` · campo de respuesta `publisher_platforms`. Solo superficies de Meta; `null` en cualquier otra fuente. No distingue mayúsculas/minúsculas en la entrada, en minúsculas en las respuestas.

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

### Niveles de alcance

Filtro `reach_tiers` · catálogo `reach_tiers[]` en Advertisement Insights. Se deriva del **límite inferior** del rango de impresiones de la fuente, por lo que un anuncio `10k-50k` se ubica en `10k_50k`. Los anuncios sin estimación de impresiones nunca coinciden con ningún nivel.

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

### Estado del anuncio

Filtro `advertisement_status` en Company Search.

| Slug                 | Significado                                                                                                             |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `currently_running`  | Empresas con publicidad registrada. Para anuncios que siguen activos, filtra con `advertisement_running_ads: [1, null]` |
| `active_last_30_min` | Los registros de anuncios de la empresa cambiaron en los últimos 30 minutos — útil para polling                         |

### Redes sociales

Filtro `social_media` en Company Search. OR por defecto.

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

### Actividad por país

`advertisement_country_activity` toma un objeto: `{ "country": "US", "rank": [null, 500] }` o `{ "country": "US", "percentile": [90, null] }`. El rango `1` corresponde al mayor anunciante en ese país. Consulta [Filtros de actividad publicitaria](/es/developer-guides/filters/overview#advertising-activity-filters).

***

## News Search

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

| Filtro                                | Vocabulario                                                                           | Dónde obtenerlo                                                        |
| ------------------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `categories`                          | Slugs de categoría como `acquires`, `partners_with`, `receives_financing`, `launches` | [News Categories](/es/api-reference/endpoint/news/categories) — `slug` |
| `news_galleries` / `news_gallery_ids` | Slug o UUID de la galería                                                             | [News Galleries](/es/api-reference/endpoint/news/galleries)            |
| `news_languages`                      | Códigos ISO 639-1 (`en`, `ja`, `ko`, `zh`, …)                                         | [News Languages](/es/api-reference/endpoint/news/languages)            |
| `locations` / `company_locations`     | Códigos de país                                                                       | [Locations](/es/api-reference/endpoint/locations/locations)            |

### Enumeraciones de señales de expansión

Solo se aplican cuando `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` (respuesta) | `low` `medium` `high` `very_high`                                                                                                       |

El vocabulario completo de expansión — etapas, actualidad, momentum — está en [Expansion Filters](/es/api-reference/endpoint/expansions/types).

***

## People Search

### Niveles de gestión

Filtro `management_levels`. Un slug desconocido se descarta cuando hay otros filtros de personas presentes; cuando es el único filtro de personas, la solicitud falla con `40037 Parameter(s) incorrect`.

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

Ten en cuenta que el slug de C-suite es `c_suite`, no `c_level`. Obtén los nombres en tu idioma desde [Management Levels](/es/api-reference/endpoint/management-levels/management-levels).

### Departamentos y funciones

| Filtro                 | Vocabulario                                                             | Dónde obtenerlo                                                         |
| ---------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `departments`          | Slugs `master_*`, p. ej. `master_engineering_technical`, `master_sales` | [Departments](/es/api-reference/endpoint/departments/departments)       |
| `department_functions` | Slugs de función, p. ej. `software_development`, `account_management`   | [Department Functions](/es/api-reference/endpoint/departments/function) |

***

## Company Search

| Filtro                                                        | Vocabulario                         | Dónde obtenerlo                                                                          |
| ------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------- |
| `verticals`, `vertical_categories`, `vertical_sub_categories` | Slugs de vertical                   | [Verticals](/es/api-reference/endpoint/verticals/verticals) y sus endpoints de categoría |
| `technologies`                                                | Slugs de tecnología                 | [Technologies](/es/api-reference/endpoint/technologies/technologies)                     |
| `employees`                                                   | Slugs de banda de tamaño de empresa | [Company Size](/es/api-reference/endpoint/company-size/company-size)                     |
| `locations`, `exclude_locations`                              | Códigos de país                     | [Locations](/es/api-reference/endpoint/locations/locations)                              |

***

## Constantes solo de respuesta

| Campo                                    | Valores                          | Significado                                                                                  |
| ---------------------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------- |
| `metadata.coverage_notes[].scope`        | `eea_uk_ch`                      | Nota de cobertura para una fuente solicitada                                                 |
| `metadata.skipped_source_types[].reason` | `country_unknown_until_enriched` | La fuente no se aplicó para los `target_locations` solicitados                               |
| `pagination.is_timeout`                  | `true` / `false`                 | La consulta de conteo excedió el tiempo de espera; `total_entries` es una estimación parcial |
| `metadata.ignored_fields`                | Array de claves de la solicitud  | Claves que el endpoint descartó por no reconocerlas                                          |

## Relacionado

<CardGroup cols={2}>
  <Card title="Resumen de filtros" icon="filter" href="/es/developer-guides/filters/overview">
    Cómo se combinan los arrays, AND/OR y `filter_conditions` en cada endpoint de búsqueda.
  </Card>

  <Card title="Códigos de estado" icon="triangle-exclamation" href="/es/api-reference/status-codes">
    La tabla completa de códigos de error.
  </Card>
</CardGroup>