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

# Énumérations et constantes

> Toutes les valeurs fixes acceptées ou renvoyées par l'API Pubrio — rangs d'ancienneté, fonctions, sources et formats publicitaires, paliers de portée, types de signaux, niveaux de management — sur une seule page.

La plupart des filtres Pubrio prennent un **slug** issu d'une liste fermée. Les listes courtes sont reproduites ici dans leur intégralité. Les listes longues et évolutives (pays, technologies, verticales, catégories d'actualités) proviennent des points de terminaison du groupe **Filters**, et cette page vous indique lequel utiliser.

<Warning>
  La plupart des filtres de recherche **ne rejettent pas** une valeur inconnue. Certains abandonnent le filtre et renvoient tout (`seniority_ranks`), d'autres l'appliquent et ne renvoient rien (`functions`, `source_types`, `reach_tiers`). Dans les deux cas, la réponse ressemble à un `200` normal. Vérifiez toujours `metadata.ignored_fields` et, pour la recherche publicitaire, `metadata.unsupported_source_types`.
</Warning>

## Conventions

| Forme                                                                   | Signification                                                                                                                                                                                                              | Exemple                        |
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `["YYYY-MM-DD", "YYYY-MM-DD"]`                                          | Fenêtre de dates inclusive `[de, à]`. Les bornes de journée suivent le fuseau horaire de votre workspace, sauf `launch_dates` et `active_dates`, qui utilisent l'UTC. Lorsque précisé, un seul élément désigne ce jour-là. | `["2026-08-01", "2026-08-31"]` |
| Date ou horodatage ISO (valeur scalaire : `created_at`, `published_at`) | À partir de cet instant, comparé en UTC.                                                                                                                                                                                   | `"2026-09-02T12:00:00Z"`       |
| `[min, max]` avec `null`                                                | Plage numérique ; `null` laisse ce côté ouvert.                                                                                                                                                                            | `[1, null]` = au moins un      |
| Tableaux de slugs                                                       | Correspond à **n'importe quelle** valeur listée (OU), sauf si vous passez la clé en ET avec [`filter_conditions`](/fr/developer-guides/filters/filter-conditions).                                                         | `["linkedin", "facebook"]`     |
| Codes pays                                                              | ISO 3166-1 alpha-2, en majuscules. Liste complète depuis [Locations](/fr/api-reference/endpoint/locations/locations).                                                                                                      | `"US"`, `"SG"`                 |

***

## Recherche d'offres d'emploi

Utilisé par [Job Search](/fr/api-reference/endpoint/companies/job_search) et repris sur chaque ligne d'offre.

### Rangs d'ancienneté

Filtre `seniority_ranks` · champ de réponse `seniority_rank`. Déterminé à partir de l'intitulé du poste.

| Rang | Palier       | Couvre                                                                                            |
| ---- | ------------ | ------------------------------------------------------------------------------------------------- |
| `5`  | executive    | VP et au-dessus, propriétaires, fondateurs, associés, comité de direction                         |
| `4`  | director     | Directeur et postes de responsable en dessous de VP                                               |
| `3`  | manager      | Manager                                                                                           |
| `2`  | senior       | Contributeur individuel senior                                                                    |
| `1`  | junior       | Débutant, stagiaire et autres contributeurs individuels                                           |
| `0`  | unclassified | Réponse uniquement — l'intitulé n'a pas pu être classé. Ce n'est pas une valeur de filtre valide. |

Une valeur en dehors de `1`–`5` est ignorée et le filtre est abandonné, donc `[7]` renvoie tout.

### Fonctions

Filtre `functions` · champ de réponse `functions` (tableau, `null` si non classé). Le même slug peut apparaître sur de nombreux intitulés ; un intitulé peut porter plusieurs slugs. Correspond à n'importe quel slug listé ; un slug non reconnu ne correspond à rien.

Les slugs les plus fréquents, par ordre décroissant de nombre d'offres :

| 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` s'écrit avec trois `m` dans les données. Recopiez-le tel quel.
</Note>

La longue traîne (plusieurs centaines de slugs supplémentaires tels que `information_security`, `supply_chain`, `devops`) utilise le même vocabulaire que la colonne `slug` de [Department Functions](/fr/api-reference/endpoint/departments/function). Le moyen le plus rapide de découvrir les slugs d'une niche est de lancer une recherche sans filtre sur quelques entreprises pertinentes et de lire le tableau `functions` des lignes obtenues.

### Types de source des offres

Champ de réponse `source_type`. `linkedin` pour la grande majorité des offres ; les jobboards partenaires indiquent leur propre slug (`wantedly`, `tw1111`, `rocketpunch`). Les lignes plus anciennes peuvent être `null`.

***

## Recherche publicitaire

Utilisé par [Advertisement Search](/fr/api-reference/endpoint/companies/advertisements_search), [Advertisement Insights](/fr/api-reference/endpoint/companies/advertisements_insights) et les filtres `advertisement_*` de [Company Search](/fr/api-reference/endpoint/companies/search).

### Types de source

Filtres `source_types` / `exclude_source_types` · champ de réponse `source_type` · `advertisement_platforms` sur Company Search.

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

`meta` est accepté comme alias de `facebook`. `facebook` couvre toutes les surfaces Meta ; affinez avec `publisher_platforms`.

### Formats

Filtre `advertisement_formats` · champ de réponse `advertisement_format_normalized`. Le libellé brut publié par la source est conservé dans `advertisement_format`.

| Slug canonique    | Libellés bruts couverts                                           |
| ----------------- | ----------------------------------------------------------------- |
| `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`           | Réponse uniquement — un libellé brut absent de ce tableau         |

### Plateformes de diffusion

Filtres `publisher_platforms` / `exclude_publisher_platforms` · champ de réponse `publisher_platforms`. Surfaces Meta uniquement ; `null` pour toute autre source. Insensible à la casse en entrée, en minuscules dans les réponses.

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

### Paliers de portée

Filtre `reach_tiers` · catalogue `reach_tiers[]` sur Advertisement Insights. Déterminé à partir de la **borne inférieure** de la fourchette d'impressions de la source, donc une publicité `10k-50k` se classe dans `10k_50k`. Les publicités sans estimation d'impressions ne correspondent jamais à un palier.

| 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+         |

### Statut publicitaire

Filtre `advertisement_status` sur Company Search.

| Slug                 | Signification                                                                                                                         |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `currently_running`  | Entreprises avec de la publicité enregistrée. Pour les publicités encore actives, filtrez avec `advertisement_running_ads: [1, null]` |
| `active_last_30_min` | Les enregistrements publicitaires de l'entreprise ont changé au cours des 30 dernières minutes — utile pour le polling                |

### Réseaux sociaux

Filtre `social_media` sur Company Search. OU par défaut.

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

### Activité par pays

`advertisement_country_activity` prend un objet : `{ "country": "US", "rank": [null, 500] }` ou `{ "country": "US", "percentile": [90, null] }`. Le rang `1` désigne le plus gros annonceur de ce pays. Voir [Filtres d'activité publicitaire](/fr/developer-guides/filters/overview#advertising-activity-filters).

***

## Recherche d'actualités

Utilisé par [News Search](/fr/api-reference/endpoint/companies/news_search) et [News Insights](/fr/api-reference/endpoint/companies/news_insights).

| Filtre                                | Vocabulaire                                                                               | Où le récupérer                                                        |
| ------------------------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `categories`                          | Slugs de catégorie tels que `acquires`, `partners_with`, `receives_financing`, `launches` | [News Categories](/fr/api-reference/endpoint/news/categories) — `slug` |
| `news_galleries` / `news_gallery_ids` | Slug ou UUID de la galerie                                                                | [News Galleries](/fr/api-reference/endpoint/news/galleries)            |
| `news_languages`                      | Codes ISO 639-1 (`en`, `ja`, `ko`, `zh`, …)                                               | [News Languages](/fr/api-reference/endpoint/news/languages)            |
| `locations` / `company_locations`     | Codes pays                                                                                | [Locations](/fr/api-reference/endpoint/locations/locations)            |

### Énumérations des signaux d'expansion

Appliquées uniquement lorsque `is_expansion_signal_available: true`.

| Champ                            | Valeurs                                                                                                                                 |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `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` (réponse) | `low` `medium` `high` `very_high`                                                                                                       |

Le vocabulaire complet de l'expansion — étapes, fraîcheur, dynamique — se trouve sur [Expansion Filters](/fr/api-reference/endpoint/expansions/types).

***

## Recherche de personnes

### Niveaux de management

Filtre `management_levels`. Un slug inconnu est abandonné si d'autres filtres de personnes sont présents ; s'il s'agit du seul filtre de personnes, la requête échoue avec `40037 Parameter(s) incorrect`.

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

Notez que le slug pour le comité de direction est `c_suite`, et non `c_level`. Récupérez les libellés dans votre langue depuis [Management Levels](/fr/api-reference/endpoint/management-levels/management-levels).

### Départements et fonctions

| Filtre                 | Vocabulaire                                                          | Où le récupérer                                                         |
| ---------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `departments`          | Slugs `master_*`, ex. `master_engineering_technical`, `master_sales` | [Departments](/fr/api-reference/endpoint/departments/departments)       |
| `department_functions` | Slugs de fonction, ex. `software_development`, `account_management`  | [Department Functions](/fr/api-reference/endpoint/departments/function) |

***

## Recherche d'entreprises

| Filtre                                                        | Vocabulaire                 | Où le récupérer                                                                                        |
| ------------------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------ |
| `verticals`, `vertical_categories`, `vertical_sub_categories` | Slugs de verticale          | [Verticals](/fr/api-reference/endpoint/verticals/verticals) et ses points de terminaison de catégories |
| `technologies`                                                | Slugs de technologie        | [Technologies](/fr/api-reference/endpoint/technologies/technologies)                                   |
| `employees`                                                   | Slugs de tranche d'effectif | [Company Size](/fr/api-reference/endpoint/company-size/company-size)                                   |
| `locations`, `exclude_locations`                              | Codes pays                  | [Locations](/fr/api-reference/endpoint/locations/locations)                                            |

***

## Constantes présentes uniquement en réponse

| Champ                                    | Valeurs                          | Signification                                                                  |
| ---------------------------------------- | -------------------------------- | ------------------------------------------------------------------------------ |
| `metadata.coverage_notes[].scope`        | `eea_uk_ch`                      | Note de couverture pour une source demandée                                    |
| `metadata.skipped_source_types[].reason` | `country_unknown_until_enriched` | La source n'a pas été appliquée pour les `target_locations` demandées          |
| `pagination.is_timeout`                  | `true` / `false`                 | La requête de comptage a expiré ; `total_entries` est une estimation partielle |
| `metadata.ignored_fields`                | Tableau de clés de requête       | Clés que le point de terminaison a écartées car non reconnues                  |

## Voir aussi

<CardGroup cols={2}>
  <Card title="Vue d'ensemble des filtres" icon="filter" href="/fr/developer-guides/filters/overview">
    Comment les tableaux, le ET/OU et `filter_conditions` se combinent sur tous les points de terminaison de recherche.
  </Card>

  <Card title="Codes de statut" icon="triangle-exclamation" href="/fr/api-reference/status-codes">
    Le tableau complet des codes d'erreur.
  </Card>
</CardGroup>