Skip to main content
POST
Поиск компаний

Авторизации

pubrio-api-key
string
header
обязательно

Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе Settings.

Тело

application/json
company_name
string

Ограничить результаты поиска конкретным названием компании.

Если введённое значение этого параметра не совпадает с названием компании, компания не появится в результатах поиска, даже если она соответствует другим параметрам. Частичные совпадения допускаются.

Пример:

"pubrio"

companies
string<uuid>[]

Список уникальных идентификаторов (domain_search_id), используемых для операций поиска компаний и людей.

company_groups
integer[]

Ограничить участниками этих групп компаний (id), например source_group_id или excluded_group_id монитора; постранично, как любой поиск.

domains
string[]

Список доменов компаний, используемых для операций поиска компаний и людей. Если получен URL вида www.pubrio.com или https://docs.pubrio.com/, система преобразует его в pubrio.com для обработки.

Пример:
linkedin_urls
string[]

Полностью сформированный URL профиля компании в LinkedIn. URL начинается с http и содержит linkedin.com/company/

Пример:
company_filters
object

Объект-обёртка для фильтров на уровне компании. Рекомендуемая группировка, визуально отделяющая, какие ключи фильтруют человека (верхний уровень), а какие — компанию. Принимает те же ключи, что и фильтры компании верхнего уровня (например, technologies, verticals, vertical_categories, vertical_sub_categories, categories, keywords, founded_dates, employees, revenues, company_locations, company_exclude_locations, company_places, company_exclude_places, companies, domains, company_linkedin_urls, is_enable_similarity_search, similarity_score, а также filter_conditions). Движок разворачивает этот объект на верхний уровень перед обработкой — при конфликте побеждают ключи верхнего уровня. Та же структура используется в company_filters монитора. Примеры см. в руководстве разработчика Filters Overview.

Пример:
locations
string[]

ISO 3166-1 alpha-2 (cca2) используется для фильтрации местоположений. Подробнее см. эндпоинты location на вкладке Filters.

Пример:
exclude_locations
string[]

ISO 3166-1 alpha-2 (cca2) используется для исключения местоположений, которые не нужно возвращать. Подробнее см. эндпоинты location на вкладке Filters.

Пример:
places
string[]

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

Пример:
exclude_places
string[]

Названия мест (город, регион) для исключения из результатов. Принимает локализованные или английские названия мест.

Пример:
job_locations
string[]

ISO 3166-1 alpha-2 (cca2) используется для фильтрации местоположений. Подробнее см. эндпоинты location на вкладке Filters.

Пример:
job_exclude_locations
string[]

Географические местоположения, исключаемые из результатов поиска вакансий.

Пример:
job_posted_dates
string[]

Диапазон дат публикации вакансии. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области.

Пример:
job_titles
string[]

Должности, связанные с людьми, которых вы хотите найти.

Результаты также будут включать должности, содержащие схожую терминологию, даже если они не совпадают точно. Например, поиск по software engineer может вернуть результаты с должностью senior software engineer.

Пример:
verticals
integer[]

Список значений vertical_id, используемых для поиска компаний в конкретной отрасли. Чтобы найти ID, вызовите эндпоинт vertical на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["AI"].

vertical_categories
integer[]

Список значений vertical_category_id, используемых для поиска компаний в конкретной категории отрасли. Чтобы найти ID, вызовите эндпоинт vertical category на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["Information Technology"].

vertical_sub_categories
integer[]

Список значений vertical_sub_category_id, используемых для поиска компаний в конкретной подкатегории отрасли. Чтобы найти ID, вызовите эндпоинт vertical sub category на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["Software"].

categories
integer[]

Список значений category_id, используемых для поиска конкретных категорий технологий, применяемых компаниями. Чтобы найти ID, вызовите эндпоинт category на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["CDN"].

technologies
integer[]

Список значений tag_id, используемых для поиска конкретных технологий, применяемых компаниями. Чтобы найти ID, вызовите эндпоинт technology на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["Shopify"].

Название продукта, которое есть в списке технологий, совпадает с этим продуктом и его собственными продуктами ("Salesforce" также совпадает с Salesforce Desk и Salesforce Service Cloud), но не с похожими; остальной текст сопоставляется по сходству.

exclude_technologies
string[]

Технологии, которые компания не должна использовать: tag_id или, при is_enable_similarity_search, названия вроде ["Shopify"]. Компания без известных технологий остаётся в выдаче.

Пример:
employees
string[][]

Диапазон количества сотрудников, работающих в компании. Позволяет находить компании по численности персонала. Можно добавить несколько диапазонов, чтобы расширить результаты поиска.

Подробнее см. эндпоинты company size на вкладке Filters.

Пример:
revenues
integer[]

Минимальный и максимальный диапазон выручки компании.

Пример:
founded_dates
integer[]

Диапазон годов основания компании. Максимальное значение — текущий год.

Пример:
keywords
string[]

Список ключевых слов для фильтрации компаний по релевантности, специализациям или описаниям.

Пример:
social_media
enum<string>[]

Компании с профилем на одной из платформ: linkedin, facebook, instagram, tiktok, twitter, x, github, wantedly, rocketpunch. Повысьте до AND с помощью filter_conditions.

Доступные опции:
linkedin,
facebook,
instagram,
tiktok,
twitter,
x,
github,
wantedly,
rocketpunch
Пример:
news_categories
string[]

Список category slugs для поиска конкретных категорий новостей. Чтобы найти слаг, вызовите эндпоинт news categories на вкладке Filters.

Пример:
news_published_dates
string[]

Диапазон дат публикации. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области.

Пример:
advertisement_search_terms
string[]

Ключевые слова, используемые для поиска в содержимом или заголовках рекламы.

Пример:
advertisement_target_locations
string[]

Целевые географические местоположения для рекламы.

Пример:
advertisement_exclude_target_locations
string[]

Географические местоположения, исключаемые из таргетинга рекламы.

Пример:
advertisement_start_dates
string<date>[]

Начало диапазона дат для фильтрации рекламы.

Пример:
advertisement_end_dates
string<date>[]

Конец диапазона дат для фильтрации рекламы.

Пример:
advertisement_active_dates
string<date>[]

Найти рекламу, показывавшуюся в любой момент в течение этого диапазона дат (на основе пересечения: включает рекламу, начавшуюся до диапазона и всё ещё показывающуюся, а не только рекламу, начавшуюся внутри него).

Пример:
advertisement_status
enum<string>[]

currently_running: компании, для которых зафиксирована реклама. active_last_30_min: компании, чья реклама изменилась за последние 30 минут.

Доступные опции:
currently_running,
active_last_30_min
Пример:
advertisement_headlines
string[]

Ключевые слова для поиска в тексте заголовка рекламы.

Пример:
advertisement_platforms
enum<string>[]

Фильтр по тому, из какой рекламной библиотеки получена реклама. В нижнем регистре, без учёта регистра. meta принимается как псевдоним для facebook.

Доступные опции:
linkedin,
facebook,
google,
tiktok,
apple
Пример:
advertisement_publisher_platforms
enum<string>[]

Фильтр рекламы Facebook/Meta по платформе показа. В нижнем регистре, без учёта регистра. Применяется только к источнику facebook (остальные источники относятся к одной платформе).

Доступные опции:
facebook,
instagram,
messenger,
threads,
audience_network
Пример:
advertisement_exclude_publisher_platforms
enum<string>[]

Исключить рекламу Facebook/Meta, показанную на этих платформах.

Доступные опции:
facebook,
instagram,
messenger,
threads,
audience_network
Пример:
advertisement_formats
enum<string>[]

Найти компании, у которых есть хотя бы одна реклама в любом из этих креативных форматов.

Доступные опции:
image,
video,
text,
carousel,
dynamic_product,
document,
message,
event,
article,
spotlight,
follow,
job,
engagement
Пример:
advertisement_active_ads
(integer | null)[]

Минимальное и максимальное количество текущих активных объявлений компании по всем странам. Используйте null для открытой границы, например [1, null] для «хотя бы одно активное объявление».

Required array length: 2 elements
Пример:
advertisement_running_ads
(integer | null)[]

Минимальное и максимальное количество объявлений компании, которые всё ещё показываются (без даты окончания или с датой окончания в будущем). В настоящее время заполняется только для рекламы LinkedIn.

Required array length: 2 elements
Пример:
advertisement_total_ads
(integer | null)[]

Минимальное и максимальное количество всех объявлений компании, когда-либо зафиксированных, по всем странам.

Required array length: 2 elements
Пример:
advertisement_platform_count
(integer | null)[]

Минимальное и максимальное количество уникальных рекламных платформ (linkedin, facebook, google, tiktok, apple), на которых компания активно размещает рекламу.

Required array length: 2 elements
Пример:
advertisement_format_count
(integer | null)[]

Минимальное и максимальное количество уникальных креативных форматов рекламы, которые компания активно использует.

Required array length: 2 elements
Пример:
advertisement_impressions_estimate
(integer | null)[]

Минимальное и максимальное расчётное количество показов рекламы, суммированное по всем странам. Учитываются только объявления с указанным диапазоном показов.

Required array length: 2 elements
Пример:
advertisement_country_activity
object

Рекламная активность для одной конкретной страны. Поле country обязательно, и должно быть задано хотя бы одно другое поле (сама по себе страна ничего не находит). Для общего итога по всем странам используйте вместо этого фильтры верхнего уровня advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate.

Пример:
sort_by
enum<string>

Порядок результатов. Не указывайте для порядка по релевантности по умолчанию. advertisement_country_rank сортирует по рекламному рангу компании внутри страны, указанной в advertisement_country_activity (ранг 1 = крупнейший рекламодатель на этом рынке), и игнорируется, если этот фильтр отсутствует. Сочетайте с is_ascending_order: false, чтобы вывести сначала самых мелких рекламодателей. Пока недоступно: name (в обоих направлениях) и relevance с is_ascending_order: false — такие запросы завершаются по тайм-ауту. Используйте порядок по релевантности по умолчанию, number_of_employees или founded_year.

Доступные опции:
relevance,
name,
number_of_employees,
founded_year,
advertisement_country_rank
Пример:

"advertisement_country_rank"

is_ascending_order
boolean

Направление сортировки для sort_by. По умолчанию — по возрастанию, что для advertisement_country_rank означает сначала крупнейших рекламодателей.

Пример:

true

filter_conditions
object[]

Расширенные параметры фильтрации для поиска компаний. Задайте условия, сочетающие ключи и логические операторы, чтобы уточнить результаты поиска.

Если включено, перечисленные выше фильтры, поддерживающие поиск по схожести, можно заполнять произвольным текстом вместо конкретных ID.

similarity_score
number<float>

Используется вместе с is_enable_similarity_search. Это число используется для анализа того, насколько конкретный слаг (например, отрасль, технология) похож на введённый пользователем текст; чем выше число, тем строже сопоставление.

Пример:

0.7

query
string

Поиск на естественном языке. Если параметр передан, Pubrio преобразует его в фильтры компаний ниже: отрасль (и исключаемые отрасли), специализация, технологии (и исключаемые инструменты), профили в соцсетях, страна, регион или город штаб-квартиры, численность сотрудников, выручка, год основания, открытые вакансии и их место, новостные события вроде "недавно расширилась", реклама (платформа, формат, целевая страна, число объявлений, показы, даты, место в одной стране) и облачный хостинг (провайдер, страны и города серверов, число хостов и серверов, всего или в одной стране). Значения, соединённые словом "или", совпадают с любым из них; инструменты или профили, соединённые словом "и" ("использует и Salesforce, и HubSpot"), должны совпадать все. Явно переданные фильтры имеют приоритет над распознанными. Часть фразы, которую не может выразить ни один фильтр (например, форма собственности), возвращается в metadata.unmatched_criteria, а не отбрасывается; фраза, в которой нечего искать, возвращает пустой результат с metadata.nl_no_intent: true.

Пример:

"Food & Beverage companies in Singapore that recently expanded"

exclude_fields
string[]

Список полей, исключаемых из полезной нагрузки ответа.

Пример:
is_parameter_metadata_available
boolean

Указывает, доступны ли метаданные параметров для запроса.

is_profile_metadata_available
boolean

Указывает, доступны ли метаданные профиля для запроса.

per_page
integer
по умолчанию:25

Количество записей на странице. По умолчанию — 25, что также является пределом на большинстве тарифов — лимит определяется параметром max_search_per_page вашей подписки, который возвращает Profile. Превышение возвращает HTTP 416 с кодом 41676 (или 41613 для поиска компаний и людей), а не усечённый набор результатов.

Требуемый диапазон: x <= 25
Пример:

25

page
integer
по умолчанию:1

Номер страницы, начиная с 1. Предел определяется параметром max_search_page вашей подписки (max_company_search_page для поиска компаний), который возвращает Profile. Превышение возвращает HTTP 416.

Пример:

1

cloud_footprint_providers
string[]

Компании, использующие любого из этих провайдеров где угодно. providers без префикса сужает записи, этот — компании.

Пример:
cloud_footprint_exclude_providers
string[]

Исключить записи, соответствующие этим облачные или хостинг-провайдеры. Только в пределах этой записи следа — один провайдер, одна страна.

Пример:
cloud_footprint_target_locations
string[]

Компании, присутствующие в любой из этих стран в любой части своего следа.

Пример:
cloud_footprint_exclude_target_locations
string[]

Исключить записи, соответствующие этим коды стран, где размещена инфраструктура.

Пример:
cloud_footprint_cloud_regions
string[]

Оставить только записи, соответствующие этим облачные регионы. Только в пределах этой записи следа — один провайдер, одна страна.

Пример:
cloud_footprint_exclude_cloud_regions
string[]

Исключить записи, соответствующие этим облачные регионы. Только в пределах этой записи следа — один провайдер, одна страна.

Пример:
cloud_footprint_cities
string[]

Оставить только записи, соответствующие этим города. Только в пределах этой записи следа — один провайдер, одна страна.

Пример:
cloud_footprint_exclude_cities
string[]

Исключить записи, соответствующие этим города. Только в пределах этой записи следа — один провайдер, одна страна.

Пример:
cloud_footprint_first_seen_dates
(string | null)[]

Две даты в формате ISO 8601 (ГГГГ-ММ-ДД), ограничивающие период, когда след был впервые обнаружен. Только в пределах этой записи следа — один провайдер, одна страна.

Required array length: 2 elements
Пример:
cloud_footprint_last_seen_dates
(string | null)[]

Две даты в формате ISO 8601 (ГГГГ-ММ-ДД), ограничивающие период, когда след был обнаружен в последний раз. Только в пределах этой записи следа — один провайдер, одна страна.

Required array length: 2 elements
Пример:
cloud_footprint_is_cross_border_only
boolean

Если true, возвращаются только записи за пределами домашнего рынка компании. Записи компаний без известной штаб-квартиры исключаются.

Пример:

true

cloud_footprint_host_count
(integer | null)[]

Минимум и максимум для хостов. Используйте null, чтобы не задавать границу. Считается по компании целиком, по всем провайдерам и странам.

Required array length: 2 elements
Пример:
cloud_footprint_server_count
(integer | null)[]

Минимум и максимум для серверов (уникальных IP). Используйте null, чтобы не задавать границу. Считается по компании целиком, по всем провайдерам и странам.

Required array length: 2 elements
Пример:
cloud_footprint_shared_server_count
(integer | null)[]

Минимум и максимум для серверов, общих с другими компаниями. Используйте null, чтобы не задавать границу. Считается по компании целиком, по всем провайдерам и странам.

Required array length: 2 elements
Пример:
cloud_footprint_provider_count
(integer | null)[]

Минимум и максимум для различных провайдеров у компании. Используйте null, чтобы не задавать границу. Считается по компании целиком, по всем провайдерам и странам.

Required array length: 2 elements
Пример:
cloud_footprint_country_count
(integer | null)[]

Минимум и максимум для стран размещения компании. Используйте null, чтобы не задавать границу. Считается по компании целиком, по всем провайдерам и странам.

Required array length: 2 elements
Пример:
cloud_footprint_cross_border_country_count
(integer | null)[]

Минимум и максимум для стран за пределами домашнего рынка. Используйте null, чтобы не задавать границу. Считается по компании целиком, по всем провайдерам и странам.

Required array length: 2 elements
Пример:
cloud_footprint_region_count
(integer | null)[]

Минимум и максимум для облачных регионов. Используйте null, чтобы не задавать границу. Считается по компании целиком, по всем провайдерам и странам.

Required array length: 2 elements
Пример:
cloud_footprint_city_count
(integer | null)[]

Минимум и максимум для городов. Используйте null, чтобы не задавать границу. Считается по компании целиком, по всем провайдерам и странам.

Required array length: 2 elements
Пример:
cloud_footprint_primary_provider
string[]

Компании, чей крупнейший провайдер — один из перечисленных.

Пример:
cloud_footprint_country_activity
object

Границы в пределах одной страны: {"country":"DE","host_count":[100,null]} находит компании со 100+ хостами именно в Германии. Обычный cloud_footprint_host_count — это итог по всем странам, поэтому вместе они этого не выражают. Один country отклоняется.

Ответ

Успешный ответ с данными поиска компаний.

metadata
object

Контекст запроса: recent_search_log_identifier, отражённые parameters и filters, необязательный кредитный блок profile и ignored_fields (ключи тела запроса, отброшенные эндпоинтом).

data
object | null

Информация об ответе зависит от конкретного эндпоинта.

Последнее изменение 4 сентября 2026 г.