개념(스테이지, 시그널, 모멘텀, 신선도)에 처음이신가요? Expansion 시그널이란? 에서 시작하세요 — 이 가이드는 해당 개념을 이미 알고 있다고 가정하며 엔드포인트 선택에 집중합니다.
작업별로 고르기
| 하고 싶은 것… | 호출 |
|---|---|
| 특정 시장으로 확장하는 회사 찾기(필터 또는 자연어 쿼리로) | Expansion Search |
| 시장 수준 KPI 및 흐름 보기(스테이지별 건수, 상위 코리도) | Expansion Overview |
| 한 회사의 특정 시장 내 상태 가져오기 — 스테이지, 진출 현황, 이력, 그리고 그 근거가 되는 시그널 | Company Expansion Detail |
| 회사의 시그널 이벤트에 대한 풍부하고 기간 범위가 지정된 피드 가져오기 | Company Signal Events |
| 대상 회사에서 시드하여, 여러 회사의 확장을 나란히 비교 | Compare Company Expansions |
| 이미 보유한 회사 집합(도메인, LinkedIn URL, 또는 ID)에 대해 바로 렌더링 가능한 비교 지표(시장 수, 모멘텀, 확장 점수) 가져오기 | Batch Company Expansion Summaries |
| 순위가 매겨진 회사/시장 포인트 를 지도나 히트맵에 표시 | Expansion Rankings |
| 필터 및 enum 값(스테이지, 시그널 유형, 신선도…) 해석 | Expansion Reference |
엔드포인트 한눈에 보기
Expansion Search
발견용 엔드포인트입니다. 회사를 확장 스테이지, 신선도, 시장, 그리고 전체 회사 펌오그래픽 세트로 필터링하거나 — 자연어
query 를 전달하세요. 페이지네이션된 회사 목록.Expansion Overview
시장 수준 집계: 스테이지별 건수, 상위 국경 간 흐름, 관심 회사 활동. 페이지네이션 없음 — 대시보드 스냅샷.
Company Expansion Detail
한 시장 내 한 회사: 현재 스테이지, 점수, 진출 현황, 전환 이력, 그리고 이를 뒷받침하는 시그널. 시장별 스냅샷.
Company Signal Events
여러 시그널 유형과 날짜 범위에 걸친 회사 시그널 이벤트의 풍부하고 페이지네이션된 피드. 활동 드릴다운.
Compare Company Expansions
한 번의 호출로 여러 회사를 나란히, 주간 시그널 시계열과 선택적 피어 시딩과 함께. 비교 그리드를 위해 설계되었습니다.
Batch Company Expansion Summaries
domain_search_id, 도메인, LinkedIn URL 을 임의로 조합해 해석한 뒤, Compare 와 동일한 데이터에 계산된 요약 블록을 더해 반환합니다 — 대상 회사도, 피어 시딩도 없습니다.
Expansion Rankings
회사/시장 쌍의 가볍고 점수순으로 정렬된 목록 — 최소 필드, 페이지네이션 없음 — 빠른 지도 및 히트맵 렌더링용.
”Detail” vs “Signal Events” — 어느 것을?
둘 다 시그널을 다루기 때문에 가장 흔히 혼동되는 지점입니다. 차이는 스냅샷 vs 피드 입니다:| Company Expansion Detail | Company Signal Events | |
|---|---|---|
| 범위 | 한 회사 × 한 시장 | 한 회사, 모든 해외 시장 에 걸쳐 |
| 시장 | country_code 로 단일 시장, 또는 is_all_markets 로 회사 전체를 한 번에 | 기본적으로 모든 해외 시장(본국 시장 제외); country_codes(배열)로 특정 시장으로 좁힘 |
| 반환 | 스테이지, 점수, 진출 현황, 이력 + 뒷받침 시그널 | 풍부한 시그널 이벤트(근거 URL, 채용 명단, 라벨) |
| 시간 | 현재 위치 | 직접 선택하는 날짜 범위(window_days — 기본 90 — 또는 transitioned_dates) |
| 형태 | 구조화된 스냅샷 객체 | 페이지네이션된 이벤트 피드(“더 보기”) |
| 사용 시점 | ”이 회사의 특정 한 시장 내 상태는 어떻고, 그 이유는?" | "이 회사의 확장을 이끄는 모든 시장의 전체 흐름을 보여줘” |
”Compare” vs “Summaries” — 어느 것을?
두 엔드포인트 모두 동일한 회사별 확장 데이터를 나란히 반환합니다. 차이는 식별자와 사용 맥락입니다:| Compare Company Expansions | Batch Company Expansion Summaries | |
|---|---|---|
| 입력 | domain_search_id 만 | domain_search_id, domain, linkedin_url 임의 조합 |
| 피어 시딩 | 선택적, seed_target 을 통해 | 없음 — 각 회사는 독립적입니다 |
| 계산된 집계 | 없음(시장 수/모멘텀/점수를 직접 계산해야 함) | 회사별 summary 블록 포함(활성/신규 시장 수, 모멘텀, 확장 점수, 단계 구성) |
| 사용 시점 | 이미 해석된 ID가 있고 하나의 대상 회사에 대해 비교 가능한 피어를 시드하고 싶을 때 | 도메인이나 LinkedIn URL로 주어진 회사가 있고 한 번의 호출로 바로 렌더링 가능한 비교 지표를 원할 때 |
전형적인 워크플로
발견
필터(또는 자연어
query)와 함께 Expansion Search 를 호출해 타깃 시장으로 확장하는 회사를 가져오세요. AI 의 “왜 일치하는지” 요약을 위해 is_explain_match: true 를 설정하세요.회사 깊이 들여다보기
결과에서
domain_search_id 를 가져와 Company Expansion Detail 을 호출해 한 시장 내 전체 정보 — 스테이지, 진출 현황, 이력, 시그널 — 를 읽으세요.공유 필터
발견용 엔드포인트(Expansion Search, Expansion Overview, Expansion Rankings)는 동일한 필터 어휘 — 확장 필터(스테이지, 궤적, 신선도, 스코프, 시그널 유형), 방향이 있는 지리 쌍(froms / tos) 및 전체 회사 펌오그래픽 세트(산업, 기술, 직원 규모, 매출, 저장된 목록) — 를 받습니다. 필터는 필터 개요 에서 한 번 익히세요. 유효한 값은 Expansion Reference 와 확장 신호의 작동 원리 카탈로그에 있습니다.
Expansion API 사용하기
인증, 첫 호출, 페이지네이션, 그리고 점수 읽기.
실전 예제
시장에서 시그널까지의 전체 워크스루.