Skip to main content
POST
Rechercher des offres d'emploi

Autorisations

pubrio-api-key
string
header
requis

Un jeton API unique qui représente les actions que vous effectuez via l'API ainsi que les autorisations et opérations correspondantes. Vous pouvez le créer dans la section Settings.

Corps

application/json
locations
string[]

Le code ISO 3166-1 alpha-2 (cca2) est utilisé pour filtrer les localisations. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:
exclude_locations
string[]

Codes de localisation ISO 3166-1 alpha-2 (cca2) à exclure des résultats d'offres d'emploi. Consultez les endpoints location sous l'onglet Filters pour connaître les codes valides.

Exemple:
location_ids
integer[]

Pays de publication par location_id Pubrio (endpoint Locations ; également présent sur chaque enregistrement). Alternative à locations.

Exemple:
company_locations
string[]

L'emplacement du siège social de l'entreprise. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:
companies
string<uuid>[]

Une liste d'identifiants uniques (domain_search_id) utilisée pour les opérations de recherche d'entreprises et de personnes.

domains
string[]

Liste de domaines d'entreprise utilisée pour les opérations de recherche d'entreprises et de personnes. Si nous recevons une URL telle que www.pubrio.com ou https://docs.pubrio.com/, le système la convertira en pubrio.com pour le traitement.

Exemple:
linkedin_urls
string[]

L'URL complète du profil d'entreprise LinkedIn. L'URL commence par http et contient linkedin.com/company/

Exemple:
search_term
string

Une chaîne de mots sur laquelle filtrer les résultats.

Exemple:

"pubrio"

search_terms
string[]

Tableau de mots-clés pour filtrer les offres d'emploi. Chaque terme est comparé au contenu de l'offre. Utilisez search_term pour une seule chaîne ou search_terms pour plusieurs mots-clés.

Exemple:
titles
string[]

Intitulés de poste associés aux personnes que vous cherchez à localiser.

Les résultats incluront également les intitulés de poste comportant une terminologie similaire, même s'ils ne correspondent pas exactement. Par exemple, une recherche pour software engineer peut renvoyer des résultats pour des personnes portant le titre senior software engineer.

Exemple:
functions
string[]

Slugs de fonction déduits du titre, par ex. engineering, sales, marketing, finance, product_management — les mêmes valeurs que celles renvoyées par les enregistrements dans functions. Les slugs inconnus ne correspondent à rien. Liste complète : Enums & Constants.

Exemple:
seniority_ranks
enum<integer>[]

Niveau d'ancienneté déduit du titre : 1 junior, 2 senior, 3 manager, 4 director, 5 executive. Les valeurs hors de la plage 1–5 sont ignorées et le filtre est abandonné. Les enregistrements renvoient leur niveau dans seniority_rank (0 = non classifié).

Options disponibles:
1,
2,
3,
4,
5
Exemple:
posted_dates
string[]

Plage de dates de la date de publication. La valeur maximale est le jour en cours. Les limites de journée suivent le fuseau horaire de votre espace de travail.

Exemple:
launch_dates
string<date>[]

Fenêtre inclusive [from, to] (UTC) sur la date de lancement : posting_date, ou le jour d'ingestion si absente. Correspond à la façon dont Job Insights compte. Une seule date correspond à ce jour-là.

Required array length: 1 - 2 elements
Exemple:
created_at
string<date-time>

Ingéré à cet instant ou après (UTC). Date ou horodatage ISO. Pour des synchronisations incrémentielles, transmettez le created_at de votre enregistrement stocké le plus récent.

Exemple:

"2026-09-02T12:00:00Z"

is_realtime_enrichment
boolean
défaut:false

Active l'enrichissement en temps réel pour une requête unique limitée à une entreprise (filtrée par domain_search_id, domains, ou linkedin_urls). Lorsque la recherche initiale ne renvoie aucun résultat, le point de terminaison extrait la source, enregistre les données de manière persistante, puis relance la recherche avant de répondre. Soumis à un délai propre à chaque route.

Exemple:

true

is_ascending_order
boolean
défaut:false

Sens de tri. Les résultats sont renvoyés du plus récent au plus ancien par défaut ; définissez true pour du plus ancien au plus récent. Il n'y a pas de sort_by sur cet endpoint — la clé de tri est fixe et indiquée dans la description de l'endpoint.

Exemple:

false

per_page
integer
défaut:25

Enregistrements par page. Par défaut 25, ce qui constitue également le plafond sur la plupart des forfaits — la limite correspond au max_search_per_page de votre abonnement, renvoyé par Profile. Le dépasser renvoie HTTP 416 avec le code 41676 (ou 41613 pour la recherche d'entreprises et de personnes), et non un ensemble de résultats tronqué.

Plage requise: x <= 25
Exemple:

25

page
integer
défaut:1

Numéro de page, à partir de 1. Le plafond correspond au max_search_page de votre abonnement (max_company_search_page pour la recherche d'entreprises), renvoyé par Profile. Le dépasser renvoie HTTP 416.

Exemple:

1

Réponse

Réponse réussie contenant les détails de la recherche d'offres d'emploi d'entreprises.

metadata
object

Contexte de la requête.

data
object
Dernière modification le 4 septembre 2026