Skip to main content
POST
Rechercher des personnes

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
search_term
string

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

Exemple:

"pubrio"

people_name
string

Filtre les résultats de recherche pour inclure un nom de personne spécifique.

Exemple:

"king"

people_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:
exclude_people_titles
string[]

Intitulés de poste à exclure. Même correspondance au niveau des mots que people_titles, donc ["senior"] supprime tout intitulé contenant ce mot. Appliqué après people_titles.

Exemple:
peoples
string<uuid>[]

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

management_levels
enum<string>[]

Niveau hiérarchique de la personne. Le slug pour la direction générale est c_suite, et non c_level. Les slugs inconnus sont abandonnés lorsque d'autres filtres de personnes sont présents, et échouent avec 40037 lorsqu'il s'agit du seul filtre. Liste complète disponible via le point de terminaison management level sous Filters.

Options disponibles:
c_suite,
director,
entry,
founder,
head,
intern,
manager,
owner,
partner,
senior,
vp
Exemple:
departments
string[]

Le champ department permet de rechercher des personnes dans des domaines d'expertise spécifiques.

Consultez les points de terminaison department sous l'onglet Filters pour plus d'informations.

Exemple:
exclude_departments
string[]

Slugs de département à exclure. Même vocabulaire que departments. Les personnes sans département enregistré sont conservées.

Exemple:
department_functions
string[]

Le champ de filtre pour les fonctions professionnelles permet de spécifier des rôles ou des domaines d'expertise particuliers lors de la recherche de personnes.

Consultez les points de terminaison department functions sous l'onglet Filters pour plus d'informations.

Exemple:
exclude_department_functions
string[]

Slugs de fonction à exclure. Même vocabulaire que department_functions. Les personnes sans fonction enregistrée sont conservées.

Exemple:
employees
string[][]

La plage numérique d'employés travaillant pour l'entreprise. Cela vous permet de trouver des entreprises en fonction de leur effectif. Vous pouvez ajouter plusieurs plages pour élargir vos résultats de recherche.

Consultez les points de terminaison company size sous l'onglet Filters pour plus d'informations.

Exemple:
people_locations
string[]

Le lieu où résident les personnes. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:
exclude_people_locations
string[]

Pays dans lesquels la personne ne doit pas résider (ISO 3166-1 alpha-2). Complément de people_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:
company_exclude_locations
string[]

Pays du siège social à exclure (ISO 3166-1 alpha-2). Complément de company_locations ; envoyer le même code dans les deux renvoie un résultat vide.

Exemple:
company_linkedin_urls
string[]

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

Exemple:
linkedin_urls
string[]

L'URL complète du profil utilisateur LinkedIn. L'URL commence par http et contient linkedin.com/in/ ou linkedin.com/pub/

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:
company_filters
object

Objet conteneur pour les filtres au niveau de l'entreprise. Regroupement recommandé qui sépare visuellement les clés filtrant la personne (premier niveau) de celles filtrant l'entreprise. Accepte les mêmes clés que les filtres d'entreprise de premier niveau (par ex. technologies, verticals, vertical_categories, vertical_sub_categories, categories, keywords, founded_dates, employees, revenues, company_locations, company_exclude_locations, company_places, company_exclude_places, companies, domains, company_linkedin_urls, is_enable_similarity_search, similarity_score, ainsi que filter_conditions). Le moteur aplatit cet objet au premier niveau avant traitement — les clés de premier niveau l'emportent en cas de conflit. Même structure utilisée par company_filters de Monitor. Consultez le guide développeur Filters Overview pour des exemples.

Exemple:
filter_conditions
object[]

Surcharge AND/OR par clé pour les filtres dans /people/search. Par défaut sur OR lorsqu'omis. Consultez le guide développeur People + Company Filters pour la référence complète de remappage des clés.

Lorsqu'activé, les filtres listés ci-dessus qui prennent en charge les recherches par similarité peuvent être remplis avec du texte libre au lieu d'ID spécifiques.

similarity_score
number<float>

Utilisé conjointement avec is_enable_similarity_search. Ce nombre sert à déterminer si un slug spécifique (par ex. secteur vertical, technologie) est similaire à la saisie de l'utilisateur ; plus le nombre est élevé, plus l'exigence est stricte.

Exemple:

0.7

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

query
string

Recherche en langage naturel. Lorsqu'elle est fournie, Pubrio l'interprète pour générer les filtres de personnes et d'entreprises ci-dessous (poste, ancienneté, département, localisation, secteur, taille de l'entreprise, etc.). Tout filtre explicite que vous transmettez également prévaut sur les filtres interprétés. Laissez vide pour rechercher uniquement via les filtres structurés.

Exemple:

"decision makers in marketing"

is_include_similar_people_titles
boolean

Lorsque cette option est activée, people_titles correspond aussi à des intitulés proches (par exemple, software engineer correspond à senior software engineer) plutôt qu'uniquement aux correspondances exactes.

people_title_similarity_score
number<float>

Utilisé conjointement avec is_include_similar_people_titles. Contrôle le degré de proximité requis pour qu'un intitulé corresponde ; plus le nombre est élevé, plus la correspondance est stricte.

Exemple:

0.9

Réponse

Réponse réussie contenant les détails de la recherche de personnes.

metadata
object

Contexte de la requête : reprend les filters et parameters envoyés, un bloc de crédit profile optionnel, et ignored_fields (les clés du corps de requête ignorées par l'endpoint).

data
object | null

Les informations de réponse dépendent du point de terminaison spécifique.