このクイックスタートは、数回の呼び出しでゼロから実際のエクスパンションシグナルを読み取れる状態まで導きます。すでに Pubrio API キーをお持ちであることを前提としています——キーの作成については認証を参照してください。
前提条件
すべての Expansion エンドポイントはPOST であり、JSON ボディを受け付けます。認証で説明されているとおり、すべてのリクエストに認証情報を含めてください。
ステップ 1 — 企業の拡大を調べる
まず 1 社から始め、その企業が拡大しているすべての市場を一覧します。ステップ 2 — 結果を読む
markets_summary の各エントリは、その企業が活動している 1 つの市場を表します：
stage_slug— その市場で企業がどこまで進んだか（exploring→scaling）。signal_count/distinct_type_count— その市場を裏付ける証拠量と、シグナルタイプの数。latest_signal_at— 最新シグナルの新しさ。signal_velocity_30d/signal_velocity_90d— 活動が加速している速さ。rank_now— その企業にとってのその市場の現在の順位（1= 最強）。is_home_market— その企業の本社所在国かどうか。
freshness、momentum）を使用します。
ステップ 3 — 市場全体を探索する
企業を起点にする代わりに市場を起点に作業するには、エクスパンション市場詳細を使用します。標準のpage / per_page パラメータでページ分割されています。
地理は有向の from → to 関係で、2 つのリストで表現します：froms（出発 / 本社の市場）と tos（到達市場）。目的に合ったパターンを選んでください：
metadata.pagination を読んで結果をページ送りします。
page をインクリメントして次のページをリクエストします。per_page はあなたのプランによって上限が設定されています——上限を超える値を明示的にリクエストすると、黙って切り詰められるのではなくエラーが返されます。
知っておきたい 2 つのデフォルト：
- 並び順 — 結果は関連度順（複数のシグナルタイプに裏付けられた企業が先、その中では新しい順）で返されます。純粋な新着順には
sort_by: "recent"を、そのほかexpansion_score/signal_count/company_rankingも指定できます。 - 軽量レスポンス — API キーのレスポンスは、デフォルトで市場ロールアップ（
metadata.aggregate、top origins/destinations、タイムライン）とモデル詳細を省略します。必要な場合はis_include_metadata: trueを渡してください。
ステップ 4 — 証拠を掘り下げる
企業の動きの背後にある個々のシグナルが必要なときは、企業シグナルイベントを呼び出します。total_entries と total_pages を返します——1 ページ目から total_pages ページ目までリクエストしてください（page < total_pages の間は続行）。
フィルタリファレンス
ほとんどの Expansion エンドポイントは、これらのフィルタを受け付けます。有効な値はエクスパンションシグナルの仕組みに一覧されています。companies フィルタは識別子タイプの任意の組み合わせを受け付けます——事前に ID へ解決する必要はありません：
次のステップ
実例で見る
市場からシグナルまでの完全なウォークスルー。
Expansion エンドポイント
すべての Expansion API エンドポイントを閲覧します。