メインコンテンツへスキップ
このクイックスタートは、数回の呼び出しでゼロから実際のエクスパンションシグナルを読み取れる状態まで導きます。すでに Pubrio API キーをお持ちであることを前提としています——キーの作成については認証を参照してください。

​
前提条件

  • Pubrio API キー（認証を参照）。
  • 企業の domain_search_id。企業検索エンドポイントから取得できます。
すべての Expansion エンドポイントは POST であり、JSON ボディを受け付けます。認証で説明されているとおり、すべてのリクエストに認証情報を含めてください。

​
ステップ 1 — 企業の拡大を調べる

まず 1 社から始め、その企業が拡大しているすべての市場を一覧します。 
POST /expansions/companies/lookup
{ "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "is_all_markets": true }

{
  "metadata": { "domain_search_id": "550e8400-e29b-41d4-a716-446655440002", "home_country_code": "US" },
  "data": { "market_count": 2, "dominant_stage_slug": "expanding", "total_signal_count": 194 },
  "markets_summary": [
    { "country_code": "GB", "stage_slug": "expanding", "is_home_market": false, "signal_count": 140, "distinct_type_count": 6, "latest_signal_at": "2026-07-08T02:42:23.544Z", "rank_now": 1 },
    { "country_code": "DE", "stage_slug": "committing", "is_home_market": false, "signal_count": 54, "distinct_type_count": 3, "latest_signal_at": "2026-06-20T00:00:00.000Z", "rank_now": 2 }
  ]
}

​
ステップ 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（到達市場）。目的に合ったパターンを選んでください： 
POST /expansions/lookup
{
  "tos": ["GB"],
  "freshness": ["fresh", "cooling"],
  "page": 1,
  "per_page": 25
}

POST /expansions/lookup
{
  "froms": ["CN"],
  "freshness": ["fresh", "cooling"],
  "page": 1,
  "per_page": 25
}

POST /expansions/lookup
{
  "froms": ["CN"],
  "tos": ["GB"],
  "page": 1,
  "per_page": 25
}
metadata.pagination を読んで結果をページ送りします。 
{
  "metadata": {
    "filters": { "tos": ["GB"], "freshness": ["fresh", "cooling"] }
  },
  "data": {
    "pagination": { "page": 1, "per_page": 25, "total_entries": 64, "total_pages": 3 },
    "companies": [ /* ... */ ]
  }
}
page をインクリメントして次のページをリクエストします。per_page はあなたのプランによって上限が設定されています。

​
ステップ 4 — 証拠を掘り下げる

企業の動きの背後にある個々のシグナルが必要なときは、企業シグナルイベントを呼び出します。 
POST /expansions/companies/pulse_events
{
  "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
  "signal_types": ["HIRE", "EXEC", "NEWS"],
  "window_days": 90,
  "page": 1
}
このエンドポイントは total_entries と total_pages を返します——1 ページ目から total_pages ページ目までリクエストしてください（page < total_pages の間は続行）。

​
フィルタリファレンス

ほとんどの Expansion エンドポイントは、これらのフィルタを受け付けます。有効な値はエクスパンションシグナルの仕組みに一覧されています。
フィルタ目的
stages1 つ以上の拡大段階に限定します。
freshness証拠の新しさで限定します。
momentum軌道（accelerating/advancing/steady/pulling_back）で限定します。
scopes市場参入のスコープで限定します。
signal_types特定のシグナルの種類に限定します。
froms出発 / 本社の市場（から拡大）。
tosターゲット市場（へ拡大）。
companiesdomain_search_id、ドメイン、または LinkedIn URL で特定企業に絞り込みます。
companies フィルタは識別子タイプの任意の組み合わせを受け付けます——事前に ID へ解決する必要はありません： 
POST /expansions/lookup
{ "companies": ["stripe.com", "airbnb.com"] }

POST /expansions/lookup
{ "companies": ["https://www.linkedin.com/company/stripe"] }

POST /expansions/lookup
{ "companies": ["550e8400-e29b-41d4-a716-446655440002"] }
フローと軌道を混同しないでください。フロー（市場間の動きの方向）は froms / tos で設定します——direction リクエストフィルタはありません。軌道（動きの進み方）は momentum フィルタで、レスポンスでは direction フィールドとして現れます。

​
次のステップ

実例で見る

市場からシグナルまでの完全なウォークスルー。

Expansion エンドポイント

すべての Expansion API エンドポイントを閲覧します。