Skip to main content
POST
Поиск облачного следа компаний

Авторизации

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

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

Тело

application/json
providers
string[]

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

Пример:
exclude_providers
string[]

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

Пример:
target_locations
string[]

Коды стран, на которые нацелены результаты. По умолчанию сочетается с filter_conditions как OR — совпадение по любому из них.

Пример:
exclude_target_locations
string[]

Коды стран, на которые не должны быть нацелены результаты. По умолчанию сочетается с filter_conditions как OR — совпадение по любому из них.

Пример:
cloud_regions
string[]

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

Пример:
exclude_cloud_regions
string[]

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

Пример:
cities
string[]

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

Пример:
exclude_cities
string[]

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

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

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

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

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

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

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

Пример:

true

host_count
(integer | null)[]

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

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

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

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

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

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

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

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

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

Required array length: 2 elements
Пример:
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
Пример:
company_locations
string[]

Местоположение штаб-квартиры компании. Подробнее см. эндпоинты location на вкладке Filters.

Пример:
cloud_footprint_id
string<uuid>

Идентификатор одной записи облачного следа.

Пример:

"f28215e6-f6ed-40c2-ac9b-d8e70164c0be"

cloud_footprint_ids
string<uuid>[]

Идентификаторы выбранных записей облачного следа для экспорта.

Пример:
companies
string<uuid>[]

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

domains
string[]

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

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

is_ascending_order
boolean
по умолчанию:false

Направление сортировки. По умолчанию результаты возвращаются от самых новых; установите true для сортировки от самых старых. У этого эндпоинта нет sort_by — ключ сортировки фиксирован и указан в описании эндпоинта.

Пример:

false

cloud_footprint_providers
string[]

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

Пример:
cloud_footprint_target_locations
string[]

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

Пример:
cloud_footprint_primary_provider
string[]

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

Пример:
domain
string

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

Пример:

"pubrio.com"

domain_search_id
string<uuid>

Уникальный идентификатор операции поиска компаний.

linkedin_urls
string[]

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

Пример:
filter_conditions
object[]

Переключает фильтр-массив с OR (по умолчанию: любое значение) на AND (все значения). Применимо к cloud_regions, exclude_cloud_regions, cities и exclude_cities.

Ответ

Постранично разбитые записи облачного следа.

The response is of type object.

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