> ## 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. # Recherche de personnes > Recherchez dans la base de données Pubrio des personnes correspondant aux critères spécifiés, tels que l'intitulé de poste, la localisation, l'entreprise et l'ancienneté. ## OpenAPI ````yaml fr-openapi POST /people/search openapi: 3.0.0 info: description: >- L'API Pubrio fournit une intelligence d'expansion de marché — des signaux en temps réel qui indiquent quand une entreprise entre sur un nouveau marché — ainsi que les données d'entreprises et de personnes qui les sous-tendent. Recherchez, consultez et enrichissez des comptes et des contacts, et abonnez-vous à des signaux de mouvement typés et datés sur plus de 200 marchés. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/fr/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/fr/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: >- Informations de profil de l'espace de travail et statistiques d'utilisation - name: Enrichment description: >- Enrichissez les fiches de personnes et d'entreprises avec des données B2B détaillées - name: Lookalike description: Trouvez des entreprises similaires à une entreprise donnée - name: Search description: >- Recherchez des personnes, des entreprises, des offres d'emploi, des actualités et des publicités à l'aide de filtres - name: Lookup description: >- Consultez des informations détaillées sur des personnes, entreprises, offres d'emploi, actualités, publicités et technologies spécifiques - name: LinkedIn description: >- Consultez les données de personnes et d'entreprises via des URL de profil LinkedIn - name: Redeem description: >- Utilisez des crédits pour débloquer les coordonnées de personnes (unitaire et par lot) - name: Channels description: >- Gérez les modèles de canaux de prospection (création, mise à jour, suppression, liste) - name: Monitor description: >- Créez et gérez des moniteurs de données avec webhooks, statistiques et traitement - name: Filters description: >- Récupérez les valeurs de filtre disponibles pour les paramètres de recherche (technologies, localisations, secteurs verticaux, etc.) - name: API Keys description: >- Listez et inspectez les journaux de requêtes API et les statistiques d'utilisation des clés API - name: Insights description: >- Informations agrégées sur les signaux des entreprises (offres d'emploi, actualités, publicités). - name: Export description: Exports de données en masse (soumis à des crédits). - name: Expansion description: >- Intelligence d'expansion de marché des entreprises : signaux, étapes, marchés et exports. externalDocs: description: >- L'API Pubrio permet de rechercher, prévisualiser et enrichir des contacts et des comptes. La base de données Pubrio fournit des données étendues de contacts B2B et de veille commerciale. url: https://docs.pubrio.com paths: /people/search: post: tags: - Search summary: Rechercher des personnes description: >- Recherchez dans la base de données Pubrio des personnes correspondant aux critères spécifiés, tels que l'intitulé de poste, la localisation, l'entreprise et l'ancienneté. operationId: people_search parameters: [] requestBody: required: true content: application/json: schema: type: object properties: search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' exclude_people_titles: $ref: '#/components/schemas/exclude_people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' exclude_departments: $ref: '#/components/schemas/exclude_departments' department_functions: $ref: '#/components/schemas/functions' exclude_department_functions: $ref: '#/components/schemas/exclude_department_functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' exclude_people_locations: $ref: '#/components/schemas/exclude_people_locations' company_locations: $ref: '#/components/schemas/company_locations' company_exclude_locations: $ref: '#/components/schemas/company_exclude_locations' company_linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' linkedin_urls: $ref: '#/components/schemas/people_linkedin_urls' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' company_filters: $ref: '#/components/schemas/company_filters' filter_conditions: $ref: '#/components/schemas/people_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' query: type: string example: decision makers in marketing description: >- 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. is_include_similar_people_titles: type: boolean description: >- 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: type: number format: float example: 0.9 description: >- 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. responses: '200': description: Réponse réussie contenant les détails de la recherche de personnes. content: application/json: schema: type: object properties: metadata: type: object description: >- 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: $ref: '#/components/schemas/data' example: metadata: filters: management_levels: - c_suite profile: null data: pagination: page: 1 per_page: 25 total_entries: 199616132 total_pages: 100 total_display_pages: 100 is_timeout: false peoples: - people_search_id: 134591fb-f0fa-41ba-9c8c-f1eb8aab8946 name: Doug McMillon first_name: Doug last_name: McMillon title: President & CEO seniority: c_suite functions: null headline: President & CEO at Walmart Inc. tagline: null introduction: null description: null departments: - c_suite subdepartments: - executive keywords: null employment_history: - title: President & CEO current: true end_date: null start_date: '2014-02-01' company_name: Walmart - title: President & CEO, Walmart International current: false end_date: '2014-01-01' start_date: '2009-02-01' company_name: Walmart - title: President & CEO current: false end_date: '2009-01-01' start_date: '2005-08-01' company_name: Sam's Club country: United States country_code: US location: United States state: Arkansas city: Bentonville wantedly_name: null rocketpunch_name: null contacts: null contact_types: [] emails: null phones: null facebook_url: null github_url: null twitter_url: null linkedin_url: http://www.linkedin.com/in/dougmcmillon wantedly_url: null rocketpunch_url: null saved_lists: null sequences: null social_metadata: {} company: company_name: Walmart company_url: http://walmart.com is_company_url_active: true domain: walmart.com domain_id: 26067151 domain_ids: - 757023267 - 368242703 - 26067151 domain_search_id: 2a0d6cd7-cc10-44d6-94ec-41fd528a11b6 founded_year: 1962 country: United States country_code: US location: United States phones: null emails: [] contacts: [] wantedly_name: null rocketpunch_name: null tiktok_name: null company_size_printed: 466,000 company_size: 466000 industry: Retail specialties: - Retail - E-commerce logo_url: >- https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg linkedin_url: http://www.linkedin.com/company/walmart facebook_url: http://facebook.com/walmart twitter_url: https://twitter.com/walmart crunchbase_url: null instagram_url: http://instagram.com/walmart youtube_url: http://youtube.com/user/walmart x_url: null github_url: null tiktok_url: null wantedly_url: null rocketpunch_url: null social_metadata: {} - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: search_term: type: string example: pubrio description: Une chaîne de mots sur laquelle filtrer les résultats. people_name: type: string example: king description: >- Filtre les résultats de recherche pour inclure un nom de personne spécifique. people_titles: type: array items: type: string example: - sales manager - marketing manager description: >- 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`. exclude_people_titles: type: array items: type: string example: - intern - assistant description: >- 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`. peoples: type: array items: type: string format: uuid description: >- Une liste d'identifiants uniques (people_search_id) utilisée pour les opérations de recherche de personnes. management_levels: type: array items: type: string enum: - c_suite - director - entry - founder - head - intern - manager - owner - partner - senior - vp example: - c_suite - vp description: >- 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. departments: type: array items: type: string example: - master_human_resources description: >- 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. exclude_departments: type: array items: type: string example: - master_human_resources description: >- Slugs de département à exclure. Même vocabulaire que `departments`. Les personnes sans département enregistré sont conservées. functions: type: array items: type: string example: - human_resources description: >- 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. exclude_department_functions: type: array items: type: string example: - software_development description: >- Slugs de fonction à exclure. Même vocabulaire que `department_functions`. Les personnes sans fonction enregistrée sont conservées. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- 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. people_locations: type: array items: type: string example: - US - SG - CN description: >- Le lieu où résident les personnes. Consultez les points de terminaison `location` sous l'onglet Filters pour plus d'informations. exclude_people_locations: type: array items: type: string example: - US description: >- Pays dans lesquels la personne ne doit **pas** résider (ISO 3166-1 alpha-2). Complément de `people_locations`. company_locations: type: array items: type: string example: - US - SG - CN description: >- L'emplacement du siège social de l'entreprise. Consultez les points de terminaison `location` sous l'onglet Filters pour plus d'informations. company_exclude_locations: type: array items: type: string example: - CN description: >- 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. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- L'URL complète du profil d'entreprise LinkedIn. L'URL commence par `http` et contient `linkedin.com/company/` people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- L'URL complète du profil utilisateur LinkedIn. L'URL commence par `http` et contient `linkedin.com/in/` ou `linkedin.com/pub/` companies: type: array items: type: string format: uuid description: >- Une liste d'identifiants uniques (domain_search_id) utilisée pour les opérations de recherche d'entreprises et de personnes. domains: type: array items: type: string example: - pubrio.com description: >- 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. company_filters: type: object description: >- 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. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and people_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - places - exclude_places - social_media example: technologies description: >- La clé de filtre spécifiant à quelle propriété appliquer l'opérateur. Les clés font référence aux noms de filtres d'entreprise unifiés (utilisez `places`, pas `company_places`). operator: type: string enum: - or - and example: and description: >- L'opérateur logique à appliquer. Utilisez 'or' pour faire correspondre l'une des valeurs spécifiées, ou 'and' pour exiger toutes les valeurs spécifiées. description: >- 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. is_enable_similarity_search: type: boolean description: >- 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: type: number format: float example: 0.7 description: >- 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. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- 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](/fr/api-reference/endpoint/profile/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é. page: type: integer example: 1 default: 1 description: >- 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](/fr/api-reference/endpoint/profile/profile). Le dépasser renvoie **HTTP 416**. data: type: object nullable: true description: >- Les informations de réponse dépendent du point de terminaison spécifique. responses: general_error: description: >- Requête invalide. La requête était mal formée ou contenait des paramètres invalides. Consultez le code d'erreur et le message pour plus de détails. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Limite de débit dépassée. Trop de requêtes ont été effectuées au cours d'une période donnée. Réessayez après la réinitialisation de la fenêtre de limitation de débit. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Erreur interne du serveur. Une erreur inattendue s'est produite sur le serveur. Contactez le support si l'erreur persiste. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- 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](https://dashboard.pubrio.com/#/settings/). in: header ````