Filtres personnes + entreprise - Pubrio Documentation

POST /people/search accepte tous les filtres entreprise que POST /companies/search accepte. Vous n’avez plus besoin de pré-récupérer les entreprises, de collecter leurs identifiants, puis de les injecter dans une seconde requête personnes — une seule requête couvre les deux couches.

Deux familles de paramètres, un seul corps

Un corps de requête /people/search se divise conceptuellement en deux familles de filtres. Elles se trouvent au même niveau dans le JSON, et vous pouvez les mélanger librement.

Niveau personne
Niveau entreprise

Filtrer sur les attributs de la personne :

Paramètre	Description
`people_titles`	Intitulés de poste (texte libre ou slug)
`management_levels`	`founder`, `c_suite`, `vp`, `director`, `manager`, …
`departments`	`master_engineering_technical`, `master_sales`, …
`department_functions`	Slugs de sous-département / fonction
`people_locations`	Codes pays du lieu de résidence de la personne
`people_groups`	Identifiants de groupes enregistrés
`peoples`	Valeurs spécifiques de `people_search_id`
`linkedin_urls`	URL LinkedIn de la personne
`social_media`	Identifiants de réseaux sociaux par plateforme

Filtrer sur les attributs de l’entreprise dans laquelle travaille la personne — mêmes noms que /companies/search, avec un petit ensemble de clés de lieu préfixées par company_ :

Paramètre	Description
`technologies`	Identifiants slug des technologies utilisées par l’entreprise
`categories`	Identifiants slug de catégorie
`verticals`	Identifiants slug de verticale
`vertical_categories`	Identifiants slug de catégorie verticale
`vertical_sub_categories`	Identifiants slug de sous-catégorie verticale
`keywords`	Mots-clés en texte libre comparés à la description de l’entreprise
`founded_dates`	Plage d’années de fondation, ex. `[2015, 2023]`
`employees`	Tranches d’effectifs, ex. `[[100, 500], [501, 1000]]`
`revenues`	Tranches de chiffre d’affaires en USD
`company_locations`	Codes pays du siège de l’entreprise
`company_exclude_locations`	Codes pays à exclure
`company_places`	Noms de villes / régions à inclure
`company_exclude_places`	Noms de villes / régions à exclure
`companies`	Valeurs spécifiques de `domain_search_id`
`domains`	Domaines d’entreprise spécifiques
`company_linkedin_urls`	URL LinkedIn de l’entreprise

Au premier niveau de /people/search, les filtres de localisation et de lieu de l’entreprise portent un préfixe company_ ; les clés brutes locations / places n’y sont pas acceptées et sont signalées dans metadata.ignored_fields. Tout le reste utilise le nom brut de l’entreprise (technologies, et non company_technologies). À l’intérieur de company_filters, les deux écritures fonctionnent.

Construire une requête en quatre étapes

Définissez le prédicat personne

Qui, exactement ? Intitulé, ancienneté, département, pays. Gardez cette couche au premier niveau du corps de la requête — le prédicat entreprise fait généralement le travail de précision.

Définissez le prédicat entreprise

Dans quelles entreprises doivent-elles travailler ? Secteur, taille, année de fondation, pays du siège, stack technologique. Regroupez ces éléments dans un objet company_filters: {...} pour qu’il soit évident à quelle couche appartient chaque clé.

Choisissez AND/OR par filtre via filter_conditions

Pour tout filtre à valeurs multiples nécessitant de la précision (ex. « utilise toutes ces technologies »), ajoutez une entrée à filter_conditions à l’intérieur de company_filters. Les valeurs par défaut sont OR.

Envoyez la requête

POST /people/search. Les deux styles sont acceptés, mais company_filters: {...} se lit plus clairement et correspond à la structure des payloads Monitors.

Exemple complet

La requête : des VP Engineering ou CTO dans des entreprises de taille moyenne basées aux États-Unis, fondées entre 2015 et 2023, employant de 100 à 5 000 personnes, utilisant à la fois Kubernetes et Docker, mais excluant les entreprises dont le siège est à San Francisco.

curl -X POST https://api.pubrio.com/people/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "people_titles": ["VP of Engineering", "CTO"],

    "company_filters": {
      "company_locations": ["US"],
      "company_exclude_places": ["San Francisco"],
      "founded_dates": [2010, 2024],
      "employees": [[100, 500], [501, 1000], [1001, 5000]],
      "technologies": ["Kubernetes", "Docker"],
      "is_enable_similarity_search": true
    },

    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/people/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "people_titles": ["VP of Engineering", "CTO"],

        "company_filters": {
            "company_locations": ["US"],
            "company_exclude_places": ["San Francisco"],
            "founded_dates": [2010, 2024],
            "employees": [[100, 500], [501, 1000], [1001, 5000]],
            "technologies": ["Kubernetes", "Docker"],
            "is_enable_similarity_search": True,
        },

        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/people/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    people_titles: ["VP of Engineering", "CTO"],

    company_filters: {
      company_locations: ["US"],
      company_exclude_places: ["San Francisco"],
      founded_dates: [2010, 2024],
      employees: [[100, 500], [501, 1000], [1001, 5000]],
      technologies: ["Kubernetes", "Docker"],
      is_enable_similarity_search: true,
    },

    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Référence du remappage des clés

Sur /people/search, les clés de localisation et de lieu de l’entreprise portent un préfixe company_. Elles correspondent aux noms de Company Search de la façon suivante :

Vous envoyez sur `/people/search`	Nom dans Company Search
`company_locations`	`locations`
`company_exclude_locations`	`exclude_locations`
`company_places`	`places`
`company_exclude_places`	`exclude_places`
`technologies`, `verticals`, `vertical_categories`, `vertical_sub_categories`, `categories`, `keywords`, `founded_dates`, `employees`, `revenues`	même nom

Les clés de filter_conditions ne prennent jamais le préfixe — utilisez technologies, verticals, keywords et les autres noms listés dans les clés prises en charge. Les filtres de localisation et de lieu correspondent toujours à n’importe quelle valeur listée.

Personnes sans entreprise

Ajouter n’importe quel filtre au niveau entreprise limite le résultat aux personnes ayant une entreprise reconnue enregistrée. Les personnes qui n’en ont pas sont exclues, même lorsqu’elles correspondent à tous les filtres au niveau personne.

Si votre recherche tombe à zéro ligne dès que vous ajoutez company_locations ou technologies, vérifiez si les personnes que vous attendez ont une entreprise liée.

Chaque personne renvoyée inclut un objet company renseigné dès qu’un filtre entreprise a été appliqué.

Modèles courants

Marketing basé sur les comptes (ABM)

Ciblez une liste fixe d’entreprises (companies ou domains), puis superposez des filtres au niveau personne pour trouver les bons acheteurs au sein de chacune d’elles.

{
  "people_titles": ["VP Marketing", "CMO"],
  "management_levels": ["vp", "c_suite"],
  "company_filters": {
    "companies": ["67c4696b-…", "f1e2d3c4-…", "0a9b8c7d-…"]
  }
}

Découverte du profil client idéal (ICP)

Décrivez le profil de l’entreprise, pas des comptes spécifiques. Utilisez des plages et des verticales — le moteur renvoie les personnes correspondantes.

{
  "people_titles": ["Head of Engineering"],
  "company_filters": {
    "verticals": [69086912],
    "company_locations": ["US", "CA"],
    "founded_dates": [2015, 2023],
    "employees": [[51, 200], [201, 500]]
  }
}

Prospection orientée technologie

Trouvez des acheteurs dans des entreprises utilisant une stack spécifique. AND sur technologies est le remplacement typique.

{
  "people_titles": ["RevOps", "Sales Operations"],
  "departments": ["master_sales"],
  "company_filters": {
    "technologies": [10191, 121],
    "filter_conditions": [
      { "key": "technologies", "operator": "and" }
    ]
  }
}

Déplacement de concurrent

Trouvez des décideurs dans des entreprises utilisant le produit d’un concurrent (une technologie) mais pas le vôtre (exclu via categories ou une passe de filtrage distincte).

{
  "people_titles": ["VP Sales"],
  "management_levels": ["vp"],
  "company_filters": {
    "technologies": [287]
  }
}

Relancez ensuite avec technologies: [114] (l’identifiant de tag de votre produit) et comparez les résultats côté client.

Étapes suivantes

filter_conditions

Référence complète — chaque clé, chaque valeur par défaut, des exemples AND/OR prêts à copier.

Vue d'ensemble des filtres

Le modèle mental derrière le moteur de filtres unifié.

Référence Recherche personnes

Schéma complet de requête/réponse pour /people/search.

Référence Recherche entreprise

Schéma complet de requête/réponse pour /companies/search.

​Deux familles de paramètres, un seul corps

​Construire une requête en quatre étapes

​Exemple complet

​Référence du remappage des clés

​Personnes sans entreprise

​Modèles courants

​Étapes suivantes

filter_conditions

Vue d'ensemble des filtres

Référence Recherche personnes

Référence Recherche entreprise

Deux familles de paramètres, un seul corps

Construire une requête en quatre étapes

Exemple complet

Référence du remappage des clés

Personnes sans entreprise

Modèles courants

Étapes suivantes