Сигналы экспансии: разобранный пример

Этот разбор следует за одним вопросом — «Какие компании выходят на рынок Великобритании прямо сейчас и почему?» — от дашборда рынка до отдельных сигналов, стоящих за движением одной компании. Каждый запрос и ответ ниже использует реальные формы Expansion API.

Сценарий

Вы продаёте компаниям, открывающим операции в Великобритании. Вам нужны самые свежие входящие движения, а затем вы хотите понять, почему одна из этих компаний расширяется, чтобы точно рассчитать время обращения.

Шаг 1 — найдите свежие входящие движения в Великобританию

Установите tos: ["GB"], чтобы найти каждую компанию, выходящую на рынок Великобритании, плюс фильтр свежести, чтобы видеть только компании, активно заходящие сейчас.

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

Ответ суммирует рынок и перечисляет компании, выходящие на него:

{
  "metadata": {
    "filters": { "tos": ["GB"], "freshness": ["fresh", "cooling"] },
    "aggregate": { "total_companies_with_signals": 64, "committing_count": 22, "expanding_count": 15 },
    "top_origins": [{ "home_country_code": "CN", "company_count": 18 }],
    "top_industries": [{ "industry": "Consumer Electronics", "count": 9 }]
  },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 64, "total_pages": 3 },
    "companies": [
      {
        "expansion_id": "6845525",
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "company_name": "Example Corp",
        "domain": "example.com",
        "home_country_code": "CN",
        "country_code": "GB",
        "industry": "Consumer Electronics",
        "stage": { "slug": "expanding", "expansion_score": 0.72, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 7 }
      }
    ]
  }
}

Отсортируйте по expansion_score, чтобы поставить самые решительные движения первыми. Здесь китайская компания (home_country_code: "CN") находится на стадии Расширение (expanding) в Великобритании с ускоряющейся траекторией — сильное, свежее входящее движение.

Ранжированный список компаний, выходящих на рынок, с указанием стадии, стрелки momentum, свежести и числа сигналов для каждой — Тот же ранжированный список — в продукте: стадия, momentum и свежесть с одного взгляда для каждой компании, подходящей под ваши фильтры.

Шаг 2 — посмотрите полную карту рынков компании

Возьмите domain_search_id и перечислите каждый рынок, на который выходит эта компания.

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 }
  ]
}

Компания выходит на рынок Великобритании и вкладывает ресурсы в Германии — полезный контекст для приоритизации нужного региона.

Рынки одной компании на карте мира, раскрашенные по стадии, с легендой стадий и лентой последней активности — Одна компания, все рынки, на которые она выходит, на карте — те же две строки, что описал JSON выше.

Шаг 3 — глубоко разберите движение в Великобритании

Углубитесь в детали по паре «компания-рынок», чтобы увидеть текущую стадию, лежащие в основе сигналы, известное присутствие и временную шкалу переходов.

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

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "country_code": "GB" },
  "data": {
    "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
    "country_code": "GB",
    "country_name": "United Kingdom",
    "stage_rank": 3,
    "stage_name": "Expanding",
    "stage": { "slug": "expanding", "expansion_score": 0.72, "scope": "entering_new_market", "direction": "advancing", "freshness": "fresh", "signal_count": 27 }
  },
  "signals": [
    {
      "signal_type_slug": "EXEC",
      "display_label": "Hired Regional VP for UK & Ireland",
      "polarity": "expansion",
      "event_date": "2026-06-20T14:00:00.000Z"
    }
  ],
  "presence": [
    { "presence_type": "office", "address": "London, UK", "known_since": "2026-03-15T00:00:00.000Z" }
  ]
}

Стадия «Расширение» подкреплена наймом старшего руководителя в Великобритании и лондонским офисом — конкретное доказательство, а не догадка.

Шаг 4 — прочитайте отдельные события

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

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

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002" },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 42, "total_pages": 2, "total_display_pages": 2, "is_timeout": false },
    "events": [
      {
        "signal_type_slug": "EXEC",
        "country_code": "GB",
        "display_label": "Hired Regional VP for UK & Ireland",
        "evidence_url": "https://www.linkedin.com/company/example-corp",
        "event_date": "2026-06-20T14:00:00.000Z"
      }
    ]
  }
}

Используйте total_pages, чтобы управлять элементом «загрузить ещё», увеличивая page, пока он не достигнет total_pages.

Лента отдельных сигналов экспансии одной компании на одном рынке, каждый с типом сигнала, ссылкой на доказательство и датой — Сами события, каждое со своим доказательством — обнаруженный облачный след, найм руководителя, серия геотаргетированной рекламы.

Что вы только что сделали

Вы прошли путь от рынка → ранжированного списка движений → полного следа одной компании → точных сигналов, стоящих за её экспансией в Великобританию. Это основной цикл Expansion API: начните широко, сузьте до компании, затем прочитайте доказательства.

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

Аутентификация, пагинация и ваши первые вызовы.

Как работают сигналы экспансии

Полный каталог значений, использованных выше.

База знаний

Руководства

Концепции

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

Сигналы экспансии: разобранный пример

Сценарий

Шаг 1 — найдите свежие входящие движения в Великобританию

Шаг 2 — посмотрите полную карту рынков компании

Шаг 3 — глубоко разберите движение в Великобритании

Шаг 4 — прочитайте отдельные события

Что вы только что сделали

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

Как работают сигналы экспансии

​Сценарий

​Шаг 1 — найдите свежие входящие движения в Великобританию

​Шаг 2 — посмотрите полную карту рынков компании

​Шаг 3 — глубоко разберите движение в Великобритании

​Шаг 4 — прочитайте отдельные события

​Что вы только что сделали

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

Как работают сигналы экспансии

Сценарий

Шаг 1 — найдите свежие входящие движения в Великобританию

Шаг 2 — посмотрите полную карту рынков компании

Шаг 3 — глубоко разберите движение в Великобритании

Шаг 4 — прочитайте отдельные события

Что вы только что сделали