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

Авторизации

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

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

Тело

application/json
domain_search_id
string
обязательно

Идентификатор компании в Pubrio.

domain
string

Основной домен компании, например stripe.com.

Пример:

"stripe.com"

linkedin_url
string

URL страницы компании в LinkedIn.

tiktok_url
string

URL профиля компании в TikTok.

wantedly_url
string

URL профиля компании в Wantedly.

tw104_url
string

URL профиля компании на 104 (Тайвань).

rocketpunch_url
string

URL профиля компании в RocketPunch.

remember_url
string

URL профиля компании в Remember.

youtrust_url
string

URL профиля компании в YOUTRUST.

company_name
string

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

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

Пример:

"pubrio"

companies
string<uuid>[]

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

domains
string[]

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

Пример:
linkedin_urls
string[]

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

Пример:
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"].

employees
string[][]

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

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

Пример:
revenues
integer[]

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

Пример:
founded_dates
integer[]

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

Пример:
keywords
string[]

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

Пример:
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>[]

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

Пример:
filter_conditions
object[]

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

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

similarity_score
number<float>

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

Пример:

0.7

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

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.

Пример:

Ответ

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

metadata
object

Контекст запроса. Содержит отражённые filters и parameters, а также блок profile с полями credit, topup_credit и total_credit_cost — единственный учёт кредитов на вызов, который возвращает API.

data
object[]

Похожие компании, ранжированные по степени схожести. Обратите внимание: этот эндпоинт возвращает простой массив — в отличие от других эндпоинтов поиска, внутри data нет обёртки pagination.

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