Skip to main content
POST
Детали экспансии компании

Авторизации

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

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

Тело

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

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

country_code
string

Целевой рынок в виде кода страны ISO 3166-1 alpha-2 (cca2). Не указывайте, чтобы автоматически выбрать самый активный рынок компании; установите is_all_markets для межрыночного обзора по всем рынкам.

Пример:

"US"

is_all_markets
boolean

Вернуть за один вызов весь охват экспансии компании по ВСЕМ рынкам, а не по одному рынку. Если true, country_code игнорируется, домашний рынок исключается из агрегатов сигналов, когда его можно определить, data становится сводкой на уровне компании (доминирующая стадия, общее количество сигналов, диапазон дат, наивысший показатель экспансии), а markets_summary перечисляет каждый рынок. По умолчанию false.

Пример:

false

signal_type
enum<string>

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

Доступные опции:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Пример:

"EXEC"

query
string

Описание на естественном языке того, что вы продаёте, или профиля покупателя, по которому вы оцениваете эту компанию. Используется только для обоснования summary от ИИ (см. is_explain_match); в отличие от поиска компаний, здесь это НЕ интерпретируется в фильтры.

Пример:

"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."

is_explain_match
boolean

Если true и указан query, summary возвращает единую сводку от ИИ по активности экспансии этой компании в текущем охвате (выбранный рынок или все зарубежные рынки, если is_all_markets равен true), составленную с учётом вашего query и обоснованную реальными сигналами компании с цитатами [n].

Пример:

true

window_days
integer
по умолчанию:90

Необязательно. Скользящее окно (в днях), ограничивающее ленту для сводки от ИИ. По умолчанию 90, если не указаны ни этот параметр, ни transitioned_dates. Не влияет на постраничный список signals (полная история).

Пример:

90

transitioned_dates
string<date>[]

Диапазон дат ISO [from, to] для окна сигналов/переходов. Имеет приоритет над window_days, если указаны оба.

Пример:
domain
string

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

Пример:

"pubrio.com"

linkedin_url
string

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

Пример:

"https://www.linkedin.com/company/pubrio"

is_include_established
boolean

Включить стадию established (давно работающие компании без активных сигналов экспансии). По умолчанию false.

Пример:

false

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

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

Пример:

1

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

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

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

25

is_include_metadata
boolean

Вернуть полную детализированную полезную нагрузку. По умолчанию трафик по ключу API компактный: блок model, показатели достоверности (stage.confidence в Company Expansion Detail, confidence_score в other_markets[] и в markers[] Rankings), а также поля established_min / share_of_detected / has_known_office опускаются, если это значение не true.

Пример:

true

summary_only
boolean

Вернуть только блок сводки по стадии (data, company, markets_summary, signal_weekly_totals, recent_signals, expansion_score, summary) и пропустить список сигналов и его агрегаты. Значительно дешевле для отображения ключевых/заголовочных блоков.

Пример:

true

markets_summary_full
boolean

Включить полный ранжированный набор рынков как markets_summary наряду с ограниченным списком other_markets.

Пример:

true

Ответ

Детали компании на рынке.

metadata
object
data
object

Контейнер результатов.

signals
object[]

Постраничные строки сигналов, лежащие в основе этой пары компания/рынок — список подтверждающих данных. Размер страницы и итоги берутся из metadata.pagination.

summary
object

Однострочная сводка стадии для пары. Только на первой странице.

company
object

Основные данные компании — название, домен, логотип и URL социальных сетей. Только на первой странице.

signal_group_totals
object[]

Количество сигналов по типу, сгруппированное по дням в вашем часовом поясе. Только на первой странице.

signal_type_totals
object[]

Итоговое количество сигналов по каждому типу за всё время. Только на первой странице.

signal_type_recent_totals
object[]

Итоговые показатели сигналов по типу за последние 12 недель. Только на первой странице.

signal_weekly_totals
object[]

Еженедельное количество сигналов для тепловой карты, то же окно, что и signal_type_recent_totals. Только на первой странице.

evidence_breakdown
object

Сводка подтверждающих данных по типу источника, вычисленная на основе возвращённых (отредактированных) сигналов. Только на первой странице.

presence
object

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

suppressions
object[]

Сигналы, исключённые из расчёта стадии, с указанием причины для каждого. Только на первой странице.

timeline
object[]

История переходов стадий для этой пары компания/рынок. Только на первой странице.

other_markets
object[]

Другие активные рынки компании. Ограничено на тарифах с ограничениями — см. other_markets_locked_count. Только на первой странице.

other_markets_locked_count
integer

Сколько дополнительных рынков ваш тариф не вернул в other_markets. 0, если ничего не было скрыто.

markets_summary
object[]

Полный ранжированный набор рынков для этой компании. Возвращается только если markets_summary_full равен true, на первой странице.

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