Skip to main content
Expansion API 는 소수의 엔드포인트로 구성되며, 각각은 회사가 새로운 시장으로 어떻게 확장해 가는지에 대한 서로 다른 질문에 답합니다. 이 가이드는 무엇을 하고 싶은지어떤 엔드포인트를 호출해야 하는지 로 연결해 주므로, 추측할 필요가 없습니다.
개념(스테이지, 시그널, 모멘텀, 신선도)에 처음이신가요? Expansion 시그널이란? 에서 시작하세요 — 이 가이드는 해당 개념을 이미 알고 있다고 가정하며 엔드포인트 선택에 집중합니다.

작업별로 고르기

엔드포인트 한눈에 보기

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

회사/시장 쌍의 가볍고 점수순으로 정렬된 목록 — 최소 필드, 페이지네이션 없음 — 빠른 지도 및 히트맵 렌더링용.

확장 신호 검색

신호 행 자체(유형, 하위 유형, 강도, 극성, 날짜별 이벤트, 출처, 증거 URL)를 기업과 시장 전반에서 조회합니다. 페이지네이션과 필터를 지원하며 기업 단위 집계는 하지 않습니다.

”Detail” vs “Signal Events” — 어느 것을?

둘 다 시그널을 다루기 때문에 가장 흔히 혼동되는 지점입니다. 차이는 스냅샷 vs 피드 입니다:
대부분의 통합에는 Company Expansion Detail 만 있으면 됩니다 — 이미 한 시장 내 회사의 스테이지를 뒷받침하는 시그널을 반환하기 때문입니다. 풍부하고 필터 가능하며 기간 범위가 지정된 이벤트 스트림(예: 활동 타임라인 UI 구축)이 특별히 필요할 때 Company Signal Events 를 사용하세요.

”Compare” vs “Summaries” — 어느 것을?

두 엔드포인트 모두 동일한 회사별 확장 데이터를 나란히 반환합니다. 차이는 식별자와 사용 맥락입니다:
대상 회사를 중심으로 경쟁사 벤치마킹 그리드를 만드시나요? Compareseed_target 을 전달해 피어를 자동으로 선택하세요. 이미 회사 집합(관심 목록, CRM 임포트, 도메인 목록)이 있고 숫자만 필요하신가요? Batch Company Expansion Summaries 를 사용하세요 — 모멘텀/점수 계산을 클라이언트 측에서 다시 구현할 필요가 없습니다.

전형적인 워크플로

발견

필터(또는 자연어 query)와 함께 Expansion Search 를 호출해 타깃 시장으로 확장하는 회사를 가져오세요. AI 의 “왜 일치하는지” 요약을 위해 is_explain_match: true 를 설정하세요.

회사 깊이 들여다보기

결과에서 domain_search_id 를 가져와 Company Expansion Detail 을 호출해 한 시장 내 전체 정보 — 스테이지, 진출 현황, 이력, 시그널 — 를 읽으세요.

활동 피드 보기(선택)

풍부하고 기간 범위가 지정된 이벤트 스트림을 위해, 관심 있는 시그널 유형과 날짜 범위와 함께 Company Signal Events 를 호출하세요.

비교 또는 지도 표시

대상 회사에서 시드된 나란히 비교하는 그리드에는 Compare Company Expansions 를, 이미 회사 집합이 있고 기성 지표를 원한다면 Batch Company Expansion Summaries 를, 순위가 매겨진 포인트를 지도에 표시하려면 Expansion Rankings 를 사용하세요.

공유 필터

발견용 엔드포인트(Expansion Search, Expansion Overview, Expansion Rankings)는 동일한 필터 어휘 — 확장 필터(스테이지, 궤적, 신선도, 스코프, 시그널 유형), 방향이 있는 지리 쌍(froms / tos) 전체 회사 펌오그래픽 세트(산업, 기술, 직원 규모, 매출, 저장된 목록) — 를 받습니다. 필터는 필터 개요 에서 한 번 익히세요. 유효한 값은 Expansion Reference확장 신호의 작동 원리 카탈로그에 있습니다.

Expansion API 사용하기

인증, 첫 호출, 페이지네이션, 그리고 점수 읽기.

실전 예제

시장에서 시그널까지의 전체 워크스루.