Operadores AND / OR

filter_conditions é um único array opcional no corpo da requisição. Cada entrada promove um filtro multivalorado do comportamento padrão OR (“corresponde a qualquer”) para AND (“corresponde a todos”), ou vice-versa. Os filtros que você não listar mantêm seus padrões.

Esquema

{
  "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 e operator são obrigatórios em toda entrada. Uma entrada que contenha apenas operator é ignorada silenciosamente — não existe uma substituição global.

Por que isso importa

O operador padrão é OR porque a maioria dos fluxos de prospecção quer alcance amplo: “pessoas em qualquer um destes países”, “empresas marcadas com qualquer uma destas verticais”. Para segmentação de alta precisão — “usa todas as ferramentas Salesforce + HubSpot + Marketo” — você precisa do AND. O custo de errar:

Queria AND, obteve OR: a resposta retorna resultados demais — você vê empresas que correspondem a apenas uma tag, não à pilha completa. Fácil de perceber, custa qualidade de resultado.
Queria OR, obteve AND: a resposta retorna poucos resultados — geralmente devolve quase nenhuma linha em filtros AND multivalorados, porque arrays do mundo real raramente contêm todos os valores solicitados. Fácil de perceber, parece uma consulta quebrada.

Chaves suportadas

O conjunto exato de chaves depende do endpoint que você está chamando:

Chave	`/companies/search`	`/people/search`	`/companies/advertisements/search`	`/companies/cloud_footprints/search`	Padrão	O que `and` significa
`technologies`	sim	sim	—	—	OR	Tem todas as tecnologias da lista
`categories`	sim	sim	—	—	OR	Marcada com todas as categorias
`verticals`	sim	sim	—	—	OR	Pertence a todas as verticais
`vertical_categories`	sim	sim	—	—	OR	Está em todas as categorias verticais
`vertical_sub_categories`	sim	sim	—	—	OR	Está em todas as subcategorias verticais
`keywords`	sim	sim	—	—	OR	A descrição contém todas as palavras-chave
`social_media`	sim	sim	—	—	OR	Tem um perfil em todas as redes listadas
`advertisement_target_locations`	sim	—	—	—	OR	O anúncio tem como alvo todos os países (endpoint de empresa)
`job_exclude_locations`	sim	—	—	—	OR	A vaga exclui todas as localizações
`target_locations`	—	—	sim	—	OR	O anúncio tem como alvo todos os países (endpoint de anúncios)
`publisher_platforms`	—	—	sim	—	OR	O anúncio é veiculado em todas as plataformas listadas
`cloud_regions`	—	—	—	sim	OR	Opera em todas as regiões de nuvem listadas
`cities`	—	—	—	sim	OR	Opera em todas as cidades listadas

Os filtros de lugar (places, exclude_places), os demais filtros exclude_* e advertisement_search_terms sempre correspondem a qualquer valor listado. Job Search e News Search não aceitam filter_conditions; seus filtros de lista sempre correspondem a qualquer valor listado.

As chaves acima espelham os arrays enum na especificação OpenAPI (company_filter_conditions, people_filter_conditions, ads_filter_conditions, cloud_footprint_filter_conditions). Enviar uma chave não suportada para um endpoint é ignorado silenciosamente.

Receitas

Todas as tecnologias (empresas)
Qualquer localização + exclusão
Campanhas de anúncios multirregionais
Pessoas em empresas com múltiplas ferramentas

Objetivo: empresas que usam tanto o Salesforce quanto o HubSpot — não apenas um deles.

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());

Remova a entrada filter_conditions para ampliar a busca para qualquer um dos dois.

Objetivo: empresas em qualquer um dos países EUA, Canadá ou Reino Unido, mas nunca em São Francisco.OR já é o padrão para locations, então deixamos implícito. exclude_places cuida do filtro negativo de forma independente — nenhuma substituição é necessária.

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());

Objetivo: anúncios que têm como alvo ativo tanto a UE quanto os EUA (campanhas multirregionais) — não anúncios de mercado único. Usa o esquema dedicado ads_filter_conditions com a chave 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());

O endpoint de anúncios usa seu próprio esquema ads_filter_conditions (conjunto de chaves menor: target_locations, publisher_platforms). As chaves que você pode substituir em /companies/search e /people/search não se aplicam aqui.

Objetivo: pessoas que trabalham em empresas que têm tanto o Salesforce quanto o HubSpot instalados — um sinal clássico de substituição de CRM. Demonstra o mecanismo unificado: mesma chave technologies, mesmo operador, mas em /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());

Erros comuns

Esquecer a key e enviar apenas operator

Não existe um botão global de “operador padrão”. Cada entrada precisa nomear um filtro específico:

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

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

Esperar que as entradas se combinem

As entradas são substituições independentes por chave — elas não se encadeiam. Listar tanto technologies quanto verticals não cria uma expressão booleana entre elas; cada uma apenas define o operador do seu próprio array.A combinação entre chaves de filtro diferentes é sempre AND (todo filtro precisa corresponder). Você não pode combinar com OR duas dimensões de filtro distintas através de filter_conditions. Se precisar de uma busca com OR verdadeiro entre filtros diferentes, execute duas requisições e combine os resultados no seu lado.

Usar AND em um array longo

AND exige que todos os valores listados estejam presentes. Com 8 ou mais valores, você quase sempre obtém zero linhas, porque a marcação no mundo real é esparsa. Mantenha os arrays com AND entre 2 e 4 valores; use OR para filtragem exploratória ou em nível de categoria.

Usar AND em um filtro de localização ou lugar

Os filtros de localização e de lugar (locations, places e suas formas company_ e exclude_) sempre correspondem a qualquer valor listado. Uma entrada em filter_conditions para eles é ignorada.

Na dúvida, omita filter_conditions primeiro e verifique se a contagem de resultados corresponde às expectativas. Adicione substituições apenas para os filtros em que o padrão não corresponde à sua intenção — isso mantém o payload da requisição menor e mais fácil de depurar.

Veja também

Visão Geral de Filtros

O modelo mental — comece aqui se filter_conditions for a sua primeira parada.

Filtros de Pessoas + Empresa

Como combinar filtros de empresa em /people/search, incluindo o remapeamento de chaves.

Referência de Company Search

Esquema completo de requisição para /companies/search (inclui company_filter_conditions).

Referência de People Search

Esquema completo de requisição para /people/search (inclui people_filter_conditions).

Monitoramento

Busca

Filtros

Pessoas

Expansão

Esquema

Por que isso importa

Chaves suportadas

Receitas

Erros comuns

Veja também

Visão Geral de Filtros

Filtros de Pessoas + Empresa

Referência de Company Search

Referência de People Search

​Esquema

​Por que isso importa

​Chaves suportadas

​Receitas

​Erros comuns

​Veja também

Visão Geral de Filtros

Filtros de Pessoas + Empresa

Referência de Company Search

Referência de People Search

Esquema

Por que isso importa

Chaves suportadas

Receitas

Erros comuns

Veja também