概念(ステージ、シグナル、モメンタム、鮮度)が初めてですか? まずは エクスパンションシグナルとは? から始めてください — このガイドはそれらを理解している前提で、エンドポイントの選択に焦点を当てています。
タスクで選ぶ
| やりたいこと | 呼ぶもの |
|---|---|
| ある市場へ拡大している 企業を見つける(フィルターまたは自然言語クエリで) | エクスパンション検索 |
| 市場レベルの KPI とフロー を見る(ステージごとの件数、主要なコリドー) | エクスパンション概要 |
| ある市場における 1 社のステータス を取得する — ステージ、プレゼンス、履歴、そしてその裏付けとなるシグナル | 企業エクスパンション詳細 |
| ある企業のシグナルイベントの エンリッチ済み・期間指定のフィード を取得する | 企業シグナルイベント |
| 対象企業からシードして、複数企業の拡大状況を並べて 比較する | 企業エクスパンション比較 |
| すでに持っている企業セット(ドメイン、LinkedIn URL、または ID)について そのまま表示に使える比較指標(市場数、モメンタム、エクスパンションスコア)を取得する | 企業エクスパンションのバッチサマリー |
| スコア順の企業/市場のポイント をマップやヒートマップにプロットする | エクスパンションランキング |
| フィルターと enum の値 を解決する(ステージ、シグナルタイプ、鮮度…) | エクスパンションリファレンス |
エンドポイント早見表
エクスパンション検索
発見用のエンドポイントです。拡大ステージ、鮮度、市場、そして企業ファーモグラフィックの全スイートで企業を絞り込む — あるいは自然言語の
query を渡します。ページネーション付きの企業リストを返します。エクスパンション概要
市場レベルの集計値: ステージごとの件数、主要なクロスボーダーフロー、ウォッチ中企業のアクティビティ。ページネーションなし — ダッシュボードのスナップショットです。
企業エクスパンション詳細
1 つの市場における 1 社: 現在のステージ、スコア、プレゼンス、遷移履歴、そして裏付けとなるシグナル。市場ごとのスナップショットです。
企業シグナルイベント
シグナルタイプと期間をまたいだ、ある企業のシグナルイベントのエンリッチ済み・ページネーション付きフィード。アクティビティのドリルダウンです。
企業エクスパンション比較
1 回の呼び出しで複数企業を並べて表示。週次のシグナル系列とオプションのピアシーディング付き。比較グリッド向けに作られています。
企業エクスパンションのバッチサマリー
domain_search_id、ドメイン、LinkedIn URL の任意の組み合わせを解決し、比較と同じデータに加えて計算済みのサマリーブロックを返します — 対象企業もピアシーディングもありません。
エクスパンションランキング
軽量でスコア順にランク付けされた企業/市場ペアのリスト — 最小限のフィールド、ページネーションなし — 高速なマップとヒートマップのレンダリング用です。
「詳細」と「シグナルイベント」 — どちらを使う?
これは最もよくある混乱ポイントです。どちらもシグナルを扱う からです。違いは スナップショットかフィードか にあります:| 企業エクスパンション詳細 | 企業シグナルイベント | |
|---|---|---|
| スコープ | 1 社 × 1 市場 | 1 社、その全ての海外市場 をまたぐ |
| 市場 | country_code で単一市場、または is_all_markets で企業全体を一度に | 既定で全ての海外市場(本国市場は除外);country_codes(配列)で特定市場に絞り込み |
| 返すもの | ステージ、スコア、プレゼンス、履歴 + 裏付けシグナル | エンリッチ済みシグナルイベント(根拠 URL、採用ロスター、ラベル) |
| 時間軸 | 現在の状況 | 任意に選んだ 期間(window_days — 既定 90 — または transitioned_dates) |
| 形状 | 構造化されたスナップショットオブジェクト | ページネーション付きのイベントフィード(「もっと読み込む」) |
| 使うとき | 「この企業のある 1 つの市場でのステータスは? その理由は?」 | 「この企業の拡大を推進している全ての市場の全ストリームを見せて」 |
「比較」と「バッチサマリー」 — どちらを使う?
どちらも同じ企業ごとのエクスパンションデータを並べて返します。違いは 識別子と使い方 です:| 企業エクスパンション比較 | 企業エクスパンションのバッチサマリー | |
|---|---|---|
| 入力 | domain_search_id のみ | domain_search_id、domain、linkedin_url の任意の組み合わせ |
| ピアシーディング | オプション、seed_target 経由 | なし — 各企業は独立しています |
| 計算済みの集計 | なし(市場数/モメンタム/スコアは自分で計算) | 企業ごとに summary ブロックを含む(アクティブ/新規市場数、モメンタム、エクスパンションスコア、ステージ構成) |
| 使うとき | 解決済みの ID があり、1 社を対象に比較可能なピアをシードしたいとき | ドメインや LinkedIn URL で企業が与えられており、1 回の呼び出しでそのまま表示できる比較指標が欲しいとき |
典型的なワークフロー
発見する
フィルター(または自然言語の
query)を付けて エクスパンション検索 を呼び、対象市場へ拡大している企業を取得します。AI による「なぜ一致するか」のサマリーが欲しい場合は is_explain_match: true を設定します。共有フィルター
発見系のエンドポイント(エクスパンション検索、エクスパンション概要、エクスパンションランキング)は同じフィルター語彙を受け付けます — 拡大フィルター(ステージ、軌道、鮮度、スコープ、シグナルタイプ)、有向地理ペア(froms / tos)および 企業ファーモグラフィックの全スイート(業種、テクノロジー、従業員規模、売上、保存済みリスト)です。フィルターは フィルター概要 で一度学べば十分です。有効な値は エクスパンションリファレンス と エクスパンションシグナルの仕組み のカタログにあります。
Expansion API を使う
認証、最初の呼び出し、ページネーション、スコアの読み方。
実践例
市場からシグナルまでの完全なウォークスルー。