Opérateurs AND / OR

filter_conditions est un tableau optionnel unique sur le corps de la requête. Chaque entrée fait passer un filtre à valeurs multiples du comportement par défaut OR (« correspond à au moins un ») à AND (« correspond à tous »), ou inversement. Les filtres que vous ne listez pas conservent leur comportement par défaut.

Schéma

{
  "filter_conditions": [
    { "key": "technologies", "operator": "and" },
    { "key": "verticals",    "operator": "or"  }
  ]
}

type FilterCondition = {
  /** Filter name to override. See "Supported keys" below. */
  key: string;
  /** Case-insensitive: "and" | "or". Default is "or" for arrays. */
  operator: "and" | "or";
};

type SearchRequest = {
  // …all your other filters…
  filter_conditions?: FilterCondition[];
};

key et operator sont tous deux obligatoires pour chaque entrée. Une entrée ne comportant que operator est silencieusement ignorée — il n’existe pas de remplacement global.

Pourquoi c’est important

L’opérateur par défaut est OR car la plupart des workflows de prospection recherchent une large couverture : « personnes dans n’importe lequel de ces pays », « entreprises taguées avec n’importe laquelle de ces verticales ». Pour un ciblage de haute précision — « utilise toutes les technologies Salesforce + HubSpot + Marketo » — vous avez besoin de AND. Le coût d’une erreur :

Vous vouliez AND, vous avez eu OR : la réponse sur-rappelle — vous voyez des entreprises qui ne correspondent qu’à un seul tag, pas à l’ensemble de la stack. Facile à repérer, coûte en qualité de résultat.
Vous vouliez OR, vous avez eu AND : la réponse sous-rappelle — elle retourne généralement un nombre de lignes proche de zéro sur les filtres AND à valeurs multiples, car les tableaux du monde réel contiennent rarement toutes les valeurs demandées. Facile à repérer, ressemble à une requête cassée.

Clés prises en charge

L’ensemble exact des clés dépend du endpoint que vous appelez :

Clé	`/companies/search`	`/people/search`	`/companies/advertisements/search`	`/companies/cloud_footprints/search`	Par défaut	Ce que signifie `and`
`technologies`	oui	oui	—	—	OR	Possède chaque technologie de la liste
`categories`	oui	oui	—	—	OR	Taguée avec chaque catégorie
`verticals`	oui	oui	—	—	OR	Appartient à chaque verticale
`vertical_categories`	oui	oui	—	—	OR	Dans chaque catégorie verticale
`vertical_sub_categories`	oui	oui	—	—	OR	Dans chaque sous-catégorie verticale
`keywords`	oui	oui	—	—	OR	La description contient chaque mot-clé
`social_media`	oui	oui	—	—	OR	Possède un profil sur chaque réseau listé
`advertisement_target_locations`	oui	—	—	—	OR	L’annonce cible chaque pays (endpoint entreprise)
`job_exclude_locations`	oui	—	—	—	OR	L’offre d’emploi exclut chaque lieu
`target_locations`	—	—	oui	—	OR	L’annonce cible chaque pays (endpoint annonces)
`publisher_platforms`	—	—	oui	—	OR	L’annonce est diffusée sur chaque plateforme listée
`cloud_regions`	—	—	—	oui	OR	Présente dans chaque région cloud listée
`cities`	—	—	—	oui	OR	Présente dans chaque ville listée

Les filtres de lieu (places, exclude_places), les autres filtres exclude_* et advertisement_search_terms correspondent toujours à n’importe quelle valeur listée. Job Search et News Search n’acceptent pas filter_conditions ; leurs filtres de liste correspondent toujours à n’importe quelle valeur listée.

Les clés ci-dessus reflètent les tableaux enum de la spécification OpenAPI (company_filter_conditions, people_filter_conditions, ads_filter_conditions, cloud_footprint_filter_conditions). L’envoi d’une clé non prise en charge pour un endpoint est silencieusement ignoré.

Exemples

Toutes les technologies (entreprises)
Lieux au choix + exclusion
Campagnes publicitaires multi-régions
Personnes dans des entreprises multi-stack

Objectif : des entreprises qui utilisent à la fois Salesforce et HubSpot — pas seulement l’une des deux.

curl -X POST https://api.pubrio.com/companies/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "technologies": [10191, 121],
    "filter_conditions": [
      { "key": "technologies", "operator": "and" }
    ],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/companies/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "technologies": [10191, 121],
        "filter_conditions": [
            { "key": "technologies", "operator": "and" }
        ],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/companies/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    technologies: [10191, 121],
    filter_conditions: [
      { key: "technologies", operator: "and" }
    ],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Supprimez l’entrée filter_conditions pour élargir la recherche à l’une ou l’autre des deux technologies.

Objectif : des entreprises situées dans n’importe lequel des pays suivants — États-Unis, Canada ou Royaume-Uni — mais jamais à San Francisco.OR est déjà la valeur par défaut pour locations, donc nous la laissons implicite. exclude_places gère le filtre négatif indépendamment — aucun remplacement n’est nécessaire.

curl -X POST https://api.pubrio.com/companies/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "locations": ["US", "CA", "GB"],
    "exclude_places": ["San Francisco"],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/companies/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "locations": ["US", "CA", "GB"],
        "exclude_places": ["San Francisco"],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/companies/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    locations: ["US", "CA", "GB"],
    exclude_places: ["San Francisco"],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Objectif : des publicités ciblant activement à la fois l’UE et les États-Unis (campagnes multi-régions) — et non des publicités mono-marché. Utilise le schéma dédié ads_filter_conditions avec la clé target_locations.

curl -X POST https://api.pubrio.com/companies/advertisements/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "target_locations": ["US", "DE", "FR"],
    "filter_conditions": [
      { "key": "target_locations", "operator": "and" }
    ],
    "start_dates": ["2026-01-01"],
    "end_dates":   ["2026-04-22"],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/companies/advertisements/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "target_locations": ["US", "DE", "FR"],
        "filter_conditions": [
            { "key": "target_locations", "operator": "and" }
        ],
        "start_dates": ["2026-01-01"],
        "end_dates":   ["2026-04-22"],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/companies/advertisements/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    target_locations: ["US", "DE", "FR"],
    filter_conditions: [
      { key: "target_locations", operator: "and" }
    ],
    start_dates: ["2026-01-01"],
    end_dates:   ["2026-04-22"],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Le endpoint des annonces utilise son propre schéma ads_filter_conditions (ensemble de clés plus restreint : target_locations, publisher_platforms). Les clés que vous pouvez remplacer sur /companies/search et /people/search ne s’appliquent pas ici.

Objectif : des personnes travaillant dans des entreprises ayant installé à la fois Salesforce et HubSpot — un signal classique de remplacement de CRM. Démontre le moteur unifié : même clé technologies, même opérateur, mais sur /people/search.

curl -X POST https://api.pubrio.com/people/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "people_titles": ["RevOps", "Sales Operations"],
    "technologies": [10191, 121],
    "filter_conditions": [
      { "key": "technologies", "operator": "and" }
    ],
    "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": ["RevOps", "Sales Operations"],
        "technologies": [10191, 121],
        "filter_conditions": [
            { "key": "technologies", "operator": "and" }
        ],
        "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: ["RevOps", "Sales Operations"],
    technologies: [10191, 121],
    filter_conditions: [
      { key: "technologies", operator: "and" }
    ],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Erreurs courantes

Oublier key, n'envoyer que operator

Il n’existe pas de bascule globale « opérateur par défaut ». Chaque entrée doit nommer un filtre spécifique :

// Ignored — no key
{ "filter_conditions": [{ "operator": "and" }] }

// Correct — overrides only the technologies filter
{ "filter_conditions": [{ "key": "technologies", "operator": "and" }] }

S'attendre à ce que les entrées se combinent

Les entrées sont des remplacements indépendants par clé — elles ne s’enchaînent pas. Lister à la fois technologies et verticals ne crée pas d’expression booléenne entre elles ; chacune définit simplement l’opérateur de son propre tableau.La combinaison entre les clés de filtre est toujours AND (chaque filtre doit correspondre). Vous ne pouvez pas combiner en OR deux dimensions de filtre distinctes via filter_conditions. Si vous avez besoin d’une véritable recherche OR entre différents filtres, exécutez deux requêtes et fusionnez les résultats côté client.

Utiliser AND sur un long tableau

AND exige que chaque valeur listée soit présente. Avec 8 valeurs ou plus, vous obtenez presque toujours zéro ligne, car le tagging en conditions réelles est épars. Limitez les tableaux avec AND à 2-4 valeurs ; utilisez OR pour un filtrage exploratoire ou au niveau catégorie.

Utiliser AND sur un filtre de localisation ou de lieu

Les filtres de localisation et de lieu (locations, places, ainsi que leurs formes company_ et exclude_) correspondent toujours à n’importe quelle valeur listée. Une entrée filter_conditions les concernant est ignorée.

En cas de doute, omettez d’abord filter_conditions et vérifiez votre nombre de résultats par rapport à vos attentes. N’ajoutez des remplacements que pour les filtres où le comportement par défaut ne correspond pas à votre intention — cela garde le payload de la requête plus léger et plus facile à déboguer.

Voir aussi

Vue d'ensemble des filtres

Le modèle mental — commencez ici si filter_conditions est votre première étape.

Filtres personnes + entreprise

Comment intégrer des filtres d’entreprise dans /people/search, y compris le remappage des clés.

Référence Recherche entreprise

Schéma complet de la requête pour /companies/search (inclut company_filter_conditions).

Référence Recherche personnes

Schéma complet de la requête pour /people/search (inclut people_filter_conditions).

Monitor

Recherche

Filtres

Personnes

Expansion

Schéma

Pourquoi c’est important

Clés prises en charge

Exemples

Erreurs courantes

Voir aussi

Vue d'ensemble des filtres

Filtres personnes + entreprise

Référence Recherche entreprise

Référence Recherche personnes

​Schéma

​Pourquoi c’est important

​Clés prises en charge

​Exemples

​Erreurs courantes

​Voir aussi

Vue d'ensemble des filtres

Filtres personnes + entreprise

Référence Recherche entreprise

Référence Recherche personnes

Schéma

Pourquoi c’est important

Clés prises en charge

Exemples

Erreurs courantes

Voir aussi