> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 확장 신호: 실전 예제

> 확장 API를 처음부터 끝까지 사용하여, 한 회사를 시장 뷰에서 개별 신호까지 따라가 보세요.

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

## 시나리오

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

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

`tos: ["GB"]`를 설정해 영국으로 **진입하는** 모든 회사를 찾고, 신선도 필터를 더하면 실제로 진입 중인 회사만 볼 수 있습니다.

```bash theme={null}
POST /expansions/lookup
{
  "tos": ["GB"],
  "freshness": ["fresh", "cooling"],
  "page": 1,
  "per_page": 25
}
```

응답은 시장을 요약하고, 그 시장으로 확장하는 회사를 나열합니다.

```json theme={null}
{
  "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`를 가져와, 해당 회사가 확장하고 있는 모든 시장을 나열합니다.

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

```json theme={null}
{
  "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`) 단계에 있습니다—적절한 지역에 우선순위를 두는 데 유용한 맥락입니다.

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

회사-시장 상세 정보로 드릴다운하여 현재 단계, 기반이 되는 신호, 알려진 현지 활동, 그리고 전환 타임라인을 확인합니다.

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

```json theme={null}
{
  "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단계 — 개별 이벤트 읽기

움직임을 이끄는 이벤트의 전체 페이지네이션 목록을 보려면, 관심 있는 신호 유형과 함께 신호 이벤트 엔드포인트를 호출합니다.

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

```json theme={null}
{
  "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의 핵심 루프입니다. 넓게 시작하고, 회사로 좁힌 다음, 증거를 읽으세요.

<CardGroup cols={2}>
  <Card title="확장 API 사용하기" href="/ko/knowledge-base/concepts/expansion-api-quickstart">
    인증, 페이지네이션, 그리고 첫 호출.
  </Card>

  <Card title="확장 신호의 작동 원리" href="/ko/knowledge-base/concepts/how-expansion-signals-work">
    위에서 사용한 값들의 전체 카탈로그.
  </Card>
</CardGroup>