Использование Expansion API

Это краткое руководство доведёт вас от нуля до чтения живых сигналов экспансии за несколько вызовов. Предполагается, что у вас уже есть ключ API Pubrio — см. Аутентификация, чтобы его создать.

Предварительные требования

Ключ API Pubrio (см. Аутентификация).
domain_search_id компании. Вы можете получить его через эндпоинт Company Search.

Все эндпоинты Expansion — это POST, принимающие JSON-тело. Включайте свои учётные данные в каждый запрос, как описано в Аутентификация.

Шаг 1 — просмотрите экспансию компании

Начните с одной компании и перечислите каждый рынок, на который она выходит.

POST /expansions/companies/lookup
{ "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "is_all_markets": true }

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "home_country_code": "US" },
  "data": { "market_count": 2, "dominant_stage_slug": "expanding", "total_signal_count": 194 },
  "markets_summary": [
    { "country_code": "GB", "stage_slug": "expanding", "is_home_market": false, "signal_count": 140, "distinct_type_count": 6, "latest_signal_at": "2026-07-08T02:42:23.544Z", "rank_now": 1 },
    { "country_code": "DE", "stage_slug": "committing", "is_home_market": false, "signal_count": 54, "distinct_type_count": 3, "latest_signal_at": "2026-06-20T00:00:00.000Z", "rank_now": 2 }
  ]
}

Шаг 2 — прочитайте результат

Каждая запись в markets_summary описывает один рынок, на котором компания активна:

stage_slug — насколько далеко компания продвинулась там (exploring → scaling).
signal_count / distinct_type_count — сколько доказательств подкрепляет рынок, по скольким типам сигналов.
latest_signal_at — свежесть самого нового сигнала.
signal_velocity_30d / signal_velocity_90d — насколько быстро набирает обороты активность.
rank_now — текущий ранг рынка для этой компании (1 = самый сильный).
is_home_market — является ли это страной штаб-квартиры компании.

Чтобы отразить самые свежие движения или отфильтровать по траектории, используйте эндпоинты обнаружения (freshness, momentum), показанные далее.

Шаг 3 — исследуйте целый рынок

Чтобы работать сначала с рынком, а не с компанией, используйте Expansion Market Detail. Он постраничный, со стандартными параметрами page / per_page. География — это направленное отношение из → в, выражаемое двумя списками: froms (исходные рынки / штаб-квартира) и tos (целевые рынки). Выберите паттерн, соответствующий вашему вопросу:

POST /expansions/search
{
  "tos": ["GB"],
  "freshness": ["fresh", "cooling"],
  "page": 1,
  "per_page": 25
}

POST /expansions/search
{
  "froms": ["CN"],
  "freshness": ["fresh", "cooling"],
  "page": 1,
  "per_page": 25
}

POST /expansions/search
{
  "froms": ["CN"],
  "tos": ["GB"],
  "page": 1,
  "per_page": 25
}

Прочитайте metadata.pagination, чтобы листать результаты постранично:

{
  "metadata": {
    "filters": { "tos": ["GB"], "freshness": ["fresh", "cooling"] }
  },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 64, "total_pages": 3 },
    "companies": [ /* ... */ ]
  }
}

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

Порядок — результаты возвращаются в порядке релевантности (сначала компании, подтверждённые несколькими типами сигналов, затем самые свежие). Передайте sort_by: "recent" для чистой хронологии, либо expansion_score / signal_count / company_ranking.
Облегчённые ответы — ответы с API-ключом по умолчанию опускают сводку по рынку (metadata.aggregate, топ источников/назначений, временную шкалу) и детали модели. Передайте is_include_metadata: true, когда они вам нужны.

Шаг 4 — углубитесь в доказательства

Когда вам нужны отдельные сигналы, стоящие за движением компании, вызовите Company Signal Events.

POST /expansions/companies/pulse_events
{
  "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
  "signal_types": ["HIRE", "EXEC", "NEWS"],
  "window_days": 90,
  "page": 1
}

Этот эндпоинт возвращает total_entries и total_pages — запрашивайте страницы с 1 по total_pages (то есть продолжайте, пока page < total_pages).

Справочник фильтрации

Большинство эндпоинтов экспансии принимают эти фильтры. Их допустимые значения перечислены в Как работают сигналы экспансии:

Фильтр	Назначение
`stages`	Ограничить одной или несколькими стадиями экспансии.
`freshness`	Ограничить по свежести доказательств.
`momentum`	Ограничить по траектории (`advancing`/`steady`/`pulling_back`).
`scopes`	Ограничить по области охвата выхода на рынок.
`signal_types`	Ограничить конкретными типами сигналов.
`froms`	Исходные рынки / штаб-квартира (расширение из).
`tos`	Целевые рынки (расширение на).
`companies`	Ограничить конкретными компаниями по `domain_search_id`, домену или URL LinkedIn.

Фильтр companies принимает любое сочетание типов идентификаторов — не нужно сначала разрешать их в ID:

POST /expansions/search
{ "companies": ["stripe.com", "airbnb.com"] }

POST /expansions/search
{ "companies": ["https://www.linkedin.com/company/stripe"] }

POST /expansions/search
{ "companies": ["550e8400-e29b-41d4-a716-446655440002"] }

Не путайте поток с траекторией. Поток (направление движения между рынками) задаётся через froms / tos — фильтра запроса direction не существует. Траектория (то, как прогрессирует движение) — это фильтр momentum, и он отражается в ответах как поле direction.

База знаний

Руководства

Концепции

Практические кейсы

Использование Expansion API

Предварительные требования

Шаг 1 — просмотрите экспансию компании

Шаг 2 — прочитайте результат

Шаг 3 — исследуйте целый рынок

Шаг 4 — углубитесь в доказательства

Справочник фильтрации

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

Разобранный пример

Эндпоинты экспансии

​Предварительные требования

​Шаг 1 — просмотрите экспансию компании

​Шаг 2 — прочитайте результат

​Шаг 3 — исследуйте целый рынок

​Шаг 4 — углубитесь в доказательства

​Справочник фильтрации

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

Разобранный пример

Эндпоинты экспансии

Предварительные требования

Шаг 1 — просмотрите экспансию компании

Шаг 2 — прочитайте результат

Шаг 3 — исследуйте целый рынок

Шаг 4 — углубитесь в доказательства

Справочник фильтрации

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