Operadores AND / OR

filter_conditions es un único array opcional en el cuerpo de la solicitud. Cada entrada promueve un filtro multivalor del comportamiento OR (“coincide con cualquiera”) por defecto a AND (“coincide con todos”), o viceversa. Los filtros que no listes conservan su comportamiento por defecto.

Esquema

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

type FilterCondition = {
  /** Nombre del filtro a anular. Ver "Claves admitidas" a continuación. */
  key: string;
  /** No distingue mayúsculas/minúsculas: "and" | "or". El valor por defecto es "or" para arrays. */
  operator: "and" | "or";
};

type SearchRequest = {
  // …todos tus demás filtros…
  filter_conditions?: FilterCondition[];
};

key y operator son obligatorios en cada entrada. Una entrada con solo operator se ignora silenciosamente — no existe una anulación global.

Por qué importa

El operador por defecto es OR porque la mayoría de los flujos de prospección buscan un alcance amplio: “personas en cualquiera de estos países”, “empresas etiquetadas con cualquiera de estos verticales”. Para segmentación de alta precisión — “usa todas de Salesforce + HubSpot + Marketo” — necesitas AND. El costo de equivocarse:

Querías AND, obtuviste OR: la respuesta sobre-recupera — ves empresas que coinciden con solo una etiqueta, no con el conjunto completo. Fácil de detectar, cuesta calidad de resultado.
Querías OR, obtuviste AND: la respuesta sub-recupera — normalmente devuelve casi cero filas en filtros multivalor con AND, porque los arrays del mundo real rara vez contienen todos los valores solicitados. Fácil de detectar, parece una consulta rota.

Internamente, el motor compila tu elección de operador a un operador nativo de array de Postgres: && (solapamiento) para OR, @> (contiene) para AND. Ambos son compatibles con índices, así que la diferencia de costo está en el tamaño del resultado, no en la latencia de la consulta.

Claves admitidas

El conjunto exacto de claves depende del endpoint que estés llamando:

Clave	`/companies/search`	`/people/search`	`/companies/advertisements/search`	Por defecto	Qué significa `and`
`technologies`	sí	sí	—	OR	Tiene todas las tecnologías de la lista
`categories`	sí	sí	—	OR	Etiquetado con todas las categorías
`verticals`	sí	sí	—	OR	Pertenece a todos los verticales
`vertical_categories`	sí	sí	—	OR	En todas las categorías de vertical
`vertical_sub_categories`	sí	sí	—	OR	En todas las subcategorías de vertical
`keywords`	sí	sí	—	OR	La descripción contiene todas las palabras clave
`places`	sí	sí	—	OR	Listado en todos los lugares
`exclude_places`	sí	sí	—	OR	Excluido de todos los lugares
`advertisement_target_locations`	sí	—	—	OR	El anuncio apunta a todos los países (endpoint de empresas)
`advertisement_exclude_target_locations`	sí	—	—	OR	El anuncio excluye todos los países
`advertisement_search_terms`	sí	—	—	OR	El texto del anuncio contiene todos los términos
`job_exclude_locations`	sí	—	—	OR	La publicación de empleo excluye todas las ubicaciones
`social_media`	—	sí	—	OR	La persona tiene todas las cuentas de redes sociales listadas
`target_locations`	—	—	sí	OR	El anuncio apunta a todos los países (endpoint de anuncios)
`exclude_target_locations`	—	—	sí	OR	El anuncio excluye todos los países

Las claves anteriores reflejan los arrays enum en la especificación OpenAPI (company_filter_conditions, people_filter_conditions, ads_filter_conditions). Enviar una clave no admitida para un endpoint se ignora silenciosamente.

Recetas

Todas las tecnologías (empresas)
Cualquier ubicación + exclusión
Campañas publicitarias multirregión
Personas en empresas con stack múltiple

Objetivo: empresas que usan todas Python, PostgreSQL y Kubernetes — no solo una.

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

Quita la entrada filter_conditions para ampliar la búsqueda a cualquiera de las tres.

Objetivo: empresas en cualquiera de EE. UU., Canadá o Reino Unido, pero nunca en San Francisco.OR ya es el valor por defecto para locations, así que lo dejamos implícito. exclude_places gestiona el filtro negativo de forma independiente — no se necesita anulación.

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: anuncios que apuntan activamente tanto a la UE como a EE. UU. (campañas multirregión) — no anuncios de un solo mercado. Usa el esquema dedicado ads_filter_conditions con la clave 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());

El endpoint de anuncios usa su propio esquema ads_filter_conditions (conjunto de claves más reducido: target_locations, exclude_target_locations). Las claves que puedes anular en /companies/search y /people/search no aplican aquí.

Objetivo: personas que trabajan en empresas que tienen instalados tanto Salesforce como HubSpot — una señal clásica de desplazamiento de CRM. Demuestra el motor unificado: misma clave technologies, mismo operador, pero en /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": [114, 287],
    "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": [114, 287],
        "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: [114, 287],
    filter_conditions: [
      { key: "technologies", operator: "and" }
    ],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

Errores comunes

Olvidar key y enviar solo operator

No existe un interruptor global de “operador por defecto”. Cada entrada debe nombrar un filtro específico:

// Se ignora — sin key
{ "filter_conditions": [{ "operator": "and" }] }

// Correcto — anula solo el filtro technologies
{ "filter_conditions": [{ "key": "technologies", "operator": "and" }] }

Esperar que las entradas se combinen

Las entradas son anulaciones independientes por clave — no se encadenan. Listar tanto technologies como verticals no crea una expresión booleana entre ellas; cada una simplemente establece el operador de su propio array.La combinación entre claves de filtro siempre es AND (todos los filtros deben coincidir). No puedes combinar con OR dos dimensiones de filtro distintas mediante filter_conditions. Si necesitas una búsqueda con un verdadero OR entre filtros diferentes, ejecuta dos solicitudes y combina los resultados en el cliente.

Usar AND en un array largo

AND es column @> ARRAY[…] — cada valor debe estar presente. Con 8 o más valores casi siempre obtienes cero filas porque el etiquetado en el mundo real es disperso. Mantén los arrays con AND anulado entre 2 y 4 valores; usa OR para filtrado exploratorio o a nivel de categoría.

Clave incorrecta en los filtros de empresa de /people/search

En /people/search, el nombre en la API de personas es company_places / company_locations. Pero dentro de filter_conditions[].key debes usar el nombre del motor — places, locations. El remapeo ocurre internamente antes de que se consulte filter_conditions.

// No anula — el motor no reconoce "company_places" como clave de filtro
{ "filter_conditions": [{ "key": "company_places", "operator": "and" }] }

// Correcto
{ "filter_conditions": [{ "key": "places", "operator": "and" }] }

Tabla de remapeo completa en la página Personas + Filtros de empresa.

Ante la duda, omite filter_conditions primero y verifica el conteo de resultados frente a tus expectativas. Añade anulaciones solo para los filtros donde el comportamiento por defecto no coincide con tu intención — esto mantiene el payload de la solicitud más pequeño y fácil de depurar.

Ver también

Resumen de filtros

El modelo mental — empieza aquí si filter_conditions es tu primera parada.

Personas + Filtros de empresa

Cómo incorporar filtros de empresa en /people/search, incluyendo el remapeo de claves.

Referencia de Company Search

Esquema completo de la solicitud para /companies/search (incluye company_filter_conditions).

Referencia de People Search

Esquema completo de la solicitud para /people/search (incluye people_filter_conditions).

Monitor

Búsqueda

Filtros

Personas

Expansión

Esquema

Por qué importa

Claves admitidas

Recetas

Errores comunes

Ver también

Resumen de filtros

Personas + Filtros de empresa

Referencia de Company Search

Referencia de People Search

​Esquema

​Por qué importa

​Claves admitidas

​Recetas

​Errores comunes

​Ver también

Resumen de filtros

Personas + Filtros de empresa

Referencia de Company Search

Referencia de People Search

Esquema

Por qué importa

Claves admitidas

Recetas

Errores comunes

Ver también