概念(ステージ、シグナル、モメンタム、鮮度)が初めてですか? まずは エクスパンションシグナルとは? から始めてください — このガイドはそれらを理解している前提で、エンドポイントの選択に焦点を当てています。
タスクで選ぶ
エンドポイント早見表
エクスパンション検索
発見用のエンドポイントです。拡大ステージ、鮮度、市場、そして企業ファーモグラフィックの全スイートで企業を絞り込む — あるいは自然言語の
query を渡します。ページネーション付きの企業リストを返します。エクスパンション概要
市場レベルの集計値: ステージごとの件数、主要なクロスボーダーフロー、ウォッチ中企業のアクティビティ。ページネーションなし — ダッシュボードのスナップショットです。
企業エクスパンション詳細
1 つの市場における 1 社: 現在のステージ、スコア、プレゼンス、遷移履歴、そして裏付けとなるシグナル。市場ごとのスナップショットです。
企業シグナルイベント
シグナルタイプと期間をまたいだ、ある企業のシグナルイベントのエンリッチ済み・ページネーション付きフィード。アクティビティのドリルダウンです。
企業エクスパンション比較
1 回の呼び出しで複数企業を並べて表示。週次のシグナル系列とオプションのピアシーディング付き。比較グリッド向けに作られています。
企業エクスパンションのバッチサマリー
domain_search_id、ドメイン、LinkedIn URL の任意の組み合わせを解決し、比較と同じデータに加えて計算済みのサマリーブロックを返します — 対象企業もピアシーディングもありません。
エクスパンションランキング
軽量でスコア順にランク付けされた企業/市場ペアのリスト — 最小限のフィールド、ページネーションなし — 高速なマップとヒートマップのレンダリング用です。
拡大シグナル検索
シグナル行そのもの（タイプ、サブタイプ、強度、極性、日付付きイベント、ソース、根拠 URL）を企業・市場を横断して検索します。ページネーションとフィルターに対応し、企業単位の集計は行いません。
「詳細」と「シグナルイベント」 — どちらを使う?
これは最もよくある混乱ポイントです。どちらもシグナルを扱う からです。違いは スナップショットかフィードか にあります:「比較」と「バッチサマリー」 — どちらを使う?
どちらも同じ企業ごとのエクスパンションデータを並べて返します。違いは 識別子と使い方 です:典型的なワークフロー
発見する
フィルター(または自然言語の
query)を付けて エクスパンション検索 を呼び、対象市場へ拡大している企業を取得します。AI による「なぜ一致するか」のサマリーが欲しい場合は is_explain_match: true を設定します。企業を深掘りする
結果から
domain_search_id を取り、企業エクスパンション詳細 を呼んで市場での全情報を読み取ります — ステージ、プレゼンス、履歴、シグナル。アクティビティフィードを見る(任意)
リッチで期間指定されたイベントストリームを得るには、関心のあるシグナルタイプと期間を指定して 企業シグナルイベント を呼びます。
比較またはマップ化する
対象企業からシードした並列グリッドには 企業エクスパンション比較 を、企業セットが既にあり出来合いの指標が欲しい場合は 企業エクスパンションのバッチサマリー を、ランク付けされたポイントをマップにプロットするには エクスパンションランキング を使います。
共有フィルター
発見系のエンドポイント(エクスパンション検索、エクスパンション概要、エクスパンションランキング)は同じフィルター語彙を受け付けます — 拡大フィルター(ステージ、軌道、鮮度、スコープ、シグナルタイプ)、有向地理ペア(froms / tos)および 企業ファーモグラフィックの全スイート(業種、テクノロジー、従業員規模、売上、保存済みリスト)です。フィルターは フィルター概要 で一度学べば十分です。有効な値は エクスパンションリファレンス と エクスパンションシグナルの仕組み のカタログにあります。
Expansion API を使う
認証、最初の呼び出し、ページネーション、スコアの読み方。
実践例
市場からシグナルまでの完全なウォークスルー。