확장 신호: 실전 예제

이 가이드는 *“지금 영국으로 확장하고 있는 회사는 어디이며, 그 이유는 무엇인가?”*라는 하나의 질문을, 시장 대시보드에서 한 회사의 움직임 뒤에 있는 개별 신호까지 따라갑니다. 아래의 모든 요청과 응답은 실제 확장 API 형식을 사용합니다.

시나리오

귀하는 **영국(United Kingdom)**에서 운영을 시작하는 회사에 제품을 판매합니다. 가장 신선한 인바운드 이동 회사를 찾은 다음, 그중 한 회사가 왜 확장하고 있는지 이해하여 아웃리치 타이밍을 잡고자 합니다.

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")가 advancing 궤적과 함께 GB에서 확장 중(expanding) 단계에 있습니다—강하고 신선한 인바운드 움직임입니다.

시장으로 확장 중인 회사의 순위 목록으로, 각 회사의 단계, 모멘텀 화살표, 신선도, 신호 수를 보여줌 — 동일한 순위 목록을 제품 화면에서 확인하세요—필터에 일치하는 모든 회사의 단계, 모멘텀, 신선도를 한눈에 볼 수 있습니다.

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

이 회사는 영국에서는 확장 중(expanding), 독일에서는 투입 중(committing) 단계에 있습니다—적절한 지역에 우선순위를 두는 데 유용한 맥락입니다.

한 회사의 시장을 세계 지도에 단계별 색상으로 표시하고, 단계 범례와 최근 활동 피드를 함께 보여줌 — 한 회사가 진출 중인 모든 시장을 지도에 표시한 모습—위 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" }
  ]
}

확장 중(expanding) 단계는 영국 고위 채용과 런던 사무소로 뒷받침됩니다—추측이 아닌 구체적인 증거입니다.

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

page가 total_pages에 도달할 때까지 page를 증가시키며 “더 보기” 컨트롤을 구동하세요.

한 시장 내 한 회사의 개별 확장 신호 피드로, 각 신호의 유형, 증거 링크, 날짜를 보여줌 — 감지된 클라우드 인프라, 임원 채용, 지역 타깃 광고 집행 등 각 이벤트와 그 증거를 보여줍니다.

방금 한 일

귀하는 시장 → 순위가 매겨진 이동 회사 목록 → 한 회사의 전체 흔적 → 그 회사의 영국 확장(expanding) 단계 뒤에 있는 정확한 신호 순으로 진행했습니다. 이것이 확장 API의 핵심 루프입니다. 넓게 시작하고, 회사로 좁힌 다음, 증거를 읽으세요.

확장 API 사용하기

인증, 페이지네이션, 그리고 첫 호출.

확장 신호의 작동 원리

위에서 사용한 값들의 전체 카탈로그.

지식베이스

가이드

개념

사례 연구

시나리오

1단계 — 영국으로 들어오는 신선한 인바운드 이동 회사 찾기

2단계 — 회사의 전체 시장 지도 보기

3단계 — 영국 움직임을 깊이 이해하기

4단계 — 개별 이벤트 읽기

방금 한 일

확장 API 사용하기

확장 신호의 작동 원리

​시나리오

​1단계 — 영국으로 들어오는 신선한 인바운드 이동 회사 찾기

​2단계 — 회사의 전체 시장 지도 보기

​3단계 — 영국 움직임을 깊이 이해하기

​4단계 — 개별 이벤트 읽기

​방금 한 일

확장 API 사용하기

확장 신호의 작동 원리

시나리오

1단계 — 영국으로 들어오는 신선한 인바운드 이동 회사 찾기

2단계 — 회사의 전체 시장 지도 보기

3단계 — 영국 움직임을 깊이 이해하기

4단계 — 개별 이벤트 읽기

방금 한 일