Фильтры по людям + компаниям

POST /people/search принимает каждый фильтр компании, который принимает POST /companies/search. Больше не нужно предварительно получать компании, собирать их ID и передавать во второй запрос по людям — один запрос выполняет оба уровня.

Два семейства параметров, одно тело

Тело запроса /people/search концептуально делится на два семейства фильтров. Они находятся на одном уровне в JSON, и вы свободно их смешиваете.

Уровень людей
Уровень компании

Фильтрация по атрибутам человека:

Параметр	Описание
`people_titles`	Должности (свободный текст или slug)
`management_levels`	`founder`, `c_suite`, `vp`, `director`, `manager`, …
`departments`	`master_engineering_technical`, `master_sales`, …
`department_functions`	Slug-и подотделов / функций
`people_locations`	Коды стран для местоположения человека
`people_groups`	ID сохранённых групп
`peoples`	Конкретные значения `people_search_id`
`linkedin_urls`	URL профилей LinkedIn человека
`social_media`	Никнеймы в соцсетях по каждой сети

Фильтрация по атрибутам компании, в которой работает человек — те же имена, что и у /companies/search, с небольшим набором ключей локации с префиксом company_:

Параметр	Описание
`technologies`	Slug ID технологий, используемых компанией
`categories`	Slug ID категорий
`verticals`	Slug ID вертикалей
`vertical_categories`	Slug ID категорий вертикалей
`vertical_sub_categories`	Slug ID подкатегорий вертикалей
`keywords`	Ключевые слова свободного текста, сопоставляемые с описанием компании
`founded_dates`	Диапазон года основания, напр. `[2015, 2023]`
`employees`	Диапазоны по числу сотрудников, напр. `[[100, 500], [501, 1000]]`
`revenues`	Диапазоны выручки в USD
`company_locations`	Коды стран для штаб-квартиры компании
`company_exclude_locations`	Коды стран для исключения
`company_places`	Названия городов/регионов для включения
`company_exclude_places`	Названия городов/регионов для исключения
`companies`	Конкретные значения `domain_search_id`
`domains`	Конкретные домены компаний
`company_linkedin_urls`	URL LinkedIn компании

На верхнем уровне /people/search фильтры локации и места компании имеют префикс company_; голые ключи locations / places там не принимаются и указываются в metadata.ignored_fields. Всё остальное использует голое имя компании (technologies, а не company_technologies). Внутри company_filters работает любое из написаний.

Постройте запрос за четыре шага

Определите предикат по людям

Кто именно? Должность, старшинство, отдел, страна. Держите этот слой на верхнем уровне тела запроса — предикат по компании обычно выполняет работу по точности.

Определите предикат по компаниям

В каких компаниях они должны работать? Отрасль, размер, год основания, страна штаб-квартиры, технологический стек. Группируйте их под объектом company_filters: {...}, чтобы было понятно, к какому слою относится каждый ключ.

Выберите AND/OR для каждого фильтра через filter_conditions

Для любого мультизначного фильтра, требующего точности (например, «использует все эти технологии»), добавьте запись в filter_conditions внутри company_filters. По умолчанию — OR.

Отправьте запрос

POST /people/search. Принимаются оба стиля, но company_filters: {...} читается яснее и соответствует форме payload’а Monitors.

Полный пример

Запрос: вице-президенты по инженерии или технические директора в компаниях среднего рынка в США, основанных между 2015 и 2023 годами, с числом сотрудников от 100 до 5 000, использующие одновременно Kubernetes и Docker, но исключая компании со штаб-квартирой в Сан-Франциско.

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

Справочник переименования ключей

На /people/search ключи локации и места компании имеют префикс company_. Они соответствуют именам Company Search следующим образом:

Вы отправляете на `/people/search`	Имя в 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`	то же имя

Ключи filter_conditions никогда не получают префикс — используйте technologies, verticals, keywords и другие имена, перечисленные в разделе Поддерживаемые ключи. Фильтры локаций и мест всегда совпадают с любым из перечисленных значений.

Люди без компании

Добавление любого фильтра уровня компании ограничивает результат людьми, у которых в записи есть распознанная компания. Люди без неё исключаются, даже если они соответствуют каждому фильтру уровня людей.

Если ваш поиск падает до нуля строк в тот момент, когда вы добавляете company_locations или technologies, проверьте, связана ли компания с людьми, которых вы ожидаете увидеть.

Каждый возвращённый человек включает заполненный объект company, когда был применён любой фильтр по компании.

Распространённые паттерны

Account-Based Marketing (ABM)

Нацельтесь на фиксированный список компаний (companies или domains), затем наложите фильтры уровня людей, чтобы найти нужных покупателей внутри каждой из них.

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

Поиск Ideal Customer Profile (ICP)

Опишите форму компании, а не конкретные аккаунты. Используйте диапазоны и вертикали — движок вернёт подходящих людей.

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

Технологически-ориентированный поиск потенциальных клиентов

Найдите покупателей в компаниях, использующих определённый стек. AND по technologies — типичное переопределение.

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

Вытеснение конкурентов

Найдите лиц, принимающих решения, в компаниях, использующих продукт конкурента (одна технология), но не ваш (исключается через categories или отдельный проход фильтрации).

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

Затем повторите запрос с technologies: [114] (ID тега вашего продукта) и сравните на стороне клиента.

Следующие шаги

filter_conditions

Полный справочник — каждый ключ, каждое значение по умолчанию, готовые к копированию рецепты AND/OR.

Filters Overview

Ментальная модель единого движка фильтров.

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

Полная схема запроса/ответа для /people/search.

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

Полная схема запроса/ответа для /companies/search.

Мониторинг

Поиск

Фильтры

Люди

Экспансия

Фильтры по людям + компаниям

Два семейства параметров, одно тело

Постройте запрос за четыре шага

Полный пример

Справочник переименования ключей

Люди без компании

Распространённые паттерны

Следующие шаги

filter_conditions

Filters Overview

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

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

​Два семейства параметров, одно тело

​Постройте запрос за четыре шага

​Полный пример

​Справочник переименования ключей

​Люди без компании

​Распространённые паттерны

​Следующие шаги

filter_conditions

Filters Overview

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

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

Два семейства параметров, одно тело

Постройте запрос за четыре шага

Полный пример

Справочник переименования ключей

Люди без компании

Распространённые паттерны

Следующие шаги