Операторы AND / OR

filter_conditions — это единственный опциональный массив в теле запроса. Каждая запись переключает один мультизначный фильтр со стандартного поведения OR («совпадает хоть один») на AND («совпадают все»), либо наоборот. Фильтры, не перечисленные в массиве, сохраняют своё поведение по умолчанию.

Схема

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

type FilterCondition = {
  /** Имя фильтра для переопределения. См. «Поддерживаемые ключи» ниже. */
  key: string;
  /** Без учёта регистра: "and" | "or". По умолчанию для массивов — "or". */
  operator: "and" | "or";
};

type SearchRequest = {
  // …все остальные ваши фильтры…
  filter_conditions?: FilterCondition[];
};

key и operator обязательны в каждой записи. Запись только с operator молча игнорируется — глобального переопределения не существует.

Почему это важно

Оператором по умолчанию является OR, потому что большинство сценариев поиска потенциальных клиентов нацелены на широкий охват: «люди в любой из этих стран», «компании, отмеченные любым из этих тегов вертикали». Для высокоточного таргетинга — «использует все из Salesforce + HubSpot + Marketo» — нужен AND. Цена ошибки:

Хотели AND, получили OR: ответ переполнен — вы видите компании, соответствующие только одному тегу, а не всему стеку. Легко заметить, страдает качество результатов.
Хотели OR, получили AND: ответ недополучает результаты — обычно возвращает почти ноль строк на мультизначных фильтрах AND, потому что реальные массивы редко содержат каждое запрошенное значение. Легко заметить, выглядит как сломанный запрос.

Поддерживаемые ключи

Точный набор ключей зависит от вызываемого эндпоинта:

Ключ	`/companies/search`	`/people/search`	`/companies/advertisements/search`	`/companies/cloud_footprints/search`	По умолчанию	Что означает `and`
`technologies`	да	да	—	—	OR	Имеет каждую технологию из списка
`categories`	да	да	—	—	OR	Отмечена каждой категорией
`verticals`	да	да	—	—	OR	Принадлежит каждой вертикали
`vertical_categories`	да	да	—	—	OR	В каждой категории вертикали
`vertical_sub_categories`	да	да	—	—	OR	В каждой подкатегории вертикали
`keywords`	да	да	—	—	OR	Описание содержит каждое ключевое слово
`social_media`	да	да	—	—	OR	Есть профиль в каждой из перечисленных сетей
`advertisement_target_locations`	да	—	—	—	OR	Реклама таргетирует каждую страну (эндпоинт компаний)
`job_exclude_locations`	да	—	—	—	OR	Вакансия исключает каждую локацию
`target_locations`	—	—	да	—	OR	Реклама таргетирует каждую страну (эндпоинт рекламы)
`publisher_platforms`	—	—	да	—	OR	Реклама размещается на каждой из перечисленных платформ
`cloud_regions`	—	—	—	да	OR	Работает в каждом из перечисленных облачных регионов
`cities`	—	—	—	да	OR	Работает в каждом из перечисленных городов

Фильтры мест (places, exclude_places), остальные фильтры exclude_* и advertisement_search_terms всегда совпадают с любым из перечисленных значений. Job Search и News Search не принимают filter_conditions; их фильтры-списки всегда совпадают с любым из перечисленных значений.

Ключи выше отражают массивы enum в спецификации OpenAPI (company_filter_conditions, people_filter_conditions, ads_filter_conditions, cloud_footprint_filter_conditions). Отправка неподдерживаемого ключа для эндпоинта молча игнорируется.

Рецепты

Все технологии (компании)
Любая из локаций + исключение
Мультирегиональные рекламные кампании
Люди в компаниях с несколькими технологиями

Цель: компании, использующие одновременно Salesforce и HubSpot — не только одну из них.

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

Уберите запись filter_conditions, чтобы расширить поиск до любой из двух.

Цель: компании в любой из США, Канады или Великобритании, но никогда в Сан-Франциско.OR уже является значением по умолчанию для locations, поэтому мы оставляем его неявно. exclude_places обрабатывает отрицательный фильтр независимо — переопределение не требуется.

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

Цель: реклама, активно таргетирующая одновременно ЕС и США (мультирегиональные кампании) — а не рекламу для одного рынка. Используется выделенная схема ads_filter_conditions с ключом 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());

Эндпоинт рекламы использует собственную схему ads_filter_conditions (меньший набор ключей: target_locations, publisher_platforms). Ключи, которые можно переопределить на /companies/search и /people/search, здесь не применяются.

Цель: люди, работающие в компаниях, у которых установлены одновременно Salesforce и HubSpot — классический сигнал вытеснения CRM. Демонстрирует единый движок: тот же ключ technologies, тот же оператор, но на /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());

Распространённые ошибки

Забыть key, отправив только operator

Глобального переключателя «оператор по умолчанию» не существует. Каждая запись должна называть конкретный фильтр:

// Игнорируется — нет key
{ "filter_conditions": [{ "operator": "and" }] }

// Верно — переопределяет только фильтр technologies
{ "filter_conditions": [{ "key": "technologies", "operator": "and" }] }

Ожидание, что записи будут комбинироваться

Записи — это независимые переопределения для каждого ключа, они не связываются в цепочку. Указание одновременно technologies и verticals не создаёт булево выражение между ними; каждая просто задаёт оператор своего собственного массива.Комбинация между ключами фильтров всегда AND (каждый фильтр должен совпасть). Вы не можете объединить через OR два разных измерения фильтрации с помощью filter_conditions. Если вам нужен настоящий поиск OR-разных-фильтров, выполните два запроса и объедините результаты на стороне клиента.

Использование AND на длинном массиве

AND требует присутствия каждого из перечисленных значений. При 8+ значениях вы почти всегда получаете ноль строк, потому что реальная разметка тегами разрежена. Держите массивы с переопределением AND в пределах 2-4 значений; используйте OR для исследовательской фильтрации или фильтрации на уровне категорий.

Использование AND на фильтре локации или места

Фильтры локаций и мест (locations, places и их формы с company_ и exclude_) всегда совпадают с любым из перечисленных значений. Запись filter_conditions для них игнорируется.

Если сомневаетесь, сначала опустите filter_conditions и сверьте количество результатов с ожиданиями. Добавляйте переопределения только для тех фильтров, где значение по умолчанию не соответствует вашему намерению — это делает тело запроса компактнее и облегчает отладку.

См. также

Filters Overview

Ментальная модель — начните отсюда, если filter_conditions для вас в новинку.

People + Company Filters

Как встроить фильтры по компании в /people/search, включая переименование ключей.

Справочник Company Search

Полная схема запроса для /companies/search (включает company_filter_conditions).

Справочник People Search

Полная схема запроса для /people/search (включает people_filter_conditions).

Мониторинг

Поиск

Фильтры

Люди

Экспансия

Схема

Почему это важно

Поддерживаемые ключи

Рецепты

Распространённые ошибки

См. также

Filters Overview

People + Company Filters

Справочник Company Search

Справочник People Search

​Схема

​Почему это важно

​Поддерживаемые ключи

​Рецепты

​Распространённые ошибки

​См. также

Filters Overview

People + Company Filters

Справочник Company Search

Справочник People Search

Схема

Почему это важно

Поддерживаемые ключи

Рецепты

Распространённые ошибки

См. также