クラウドフットプリント検索

クラウドフットプリント検索は「1 社 × 1 プロバイダー × 1 か国」で 1 行を返します。ドイツで AWS、シンガポールで Cloudflare を使う企業は 2 行になります。各行には、その拠点の規模、関係するクラウドリージョンと都市、初回と直近の観測時期が含まれます。

cURL

curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_locations": ["DE"],
    "providers": ["AWS"],
    "first_seen_dates": ["2026-07-01", null],
    "host_count": [100, null],
    "per_page": 25
  }'

使いどころ

市場参入の検出。 first_seen_dates で、指定期間内にその国で初めてインフラが現れた企業を抽出します。
規模で絞り込む。 host_count と server_count で、名ばかりの拠点と実運用を区別します。
スタックで分類。 providers と cloud_regions で、特定のプラットフォームやリージョンの企業を見つけます。
拡大を捉える。 is_cross_border_only は自国市場以外の拠点だけを返します。

企業で絞り込む

Key	Value
`domains`	`["stripe.com"]`
`domain`	`"stripe.com"`
`linkedin_urls`	`["https://www.linkedin.com/company/stripe"]`
`companies`	`["db26de04-…"]` — `domain_search_id` values
`domain_search_id`	`"db26de04-…"`

企業を指定しない検索も可能で、リスト作成では通常この方法を使います。例：{"target_locations": ["DE"], "providers": ["AWS"]}

フィルター

プロバイダー・リージョン・都市

Key	Example
`providers`	`["AWS", "Cloudflare"]`
`cloud_regions`	`["eu-central-1", "westeurope"]`
`cities`	`["Frankfurt", "Ashburn"]`

いずれもリストを取り、exclude_ 版があります。cloud_regions と cities は行上の配列なので、filter_conditions で OR（いずれか）から AND（すべて）に切り替えられます。

インフラの所在地

Key	Example
`target_locations`	`["DE", "SG"]`
`company_locations`	`["US"]`

target_locations はインフラが稼働する場所、company_locations は本社の所在地です。この 2 つが異なる行こそ注目に値します。

規模

Key	Meaning
`host_count`	Hosts on this row
`server_count`	Distinct IP addresses
`shared_server_count`	Servers shared with other companies
`region_count`	Cloud regions
`city_count`	Cities

5 つとも [min, max] を取り、null で片側を開放できます。いずれもこの行（1 プロバイダー × 1 か国）のみを表します。

出現時期

Key	Example
`first_seen_dates`	`["2026-07-01", null]`
`last_seen_dates`	`[null, "2026-06-30"]`

どちらも ISO 日付の [from, to] を取り、いずれの端も null で開放できます。first_seen_dates は市場参入の、last_seen_dates はその逆の問いに答えます。

クロスボーダーのみ

is_cross_border_only: true で自国市場以外の拠点だけに絞ります。本社が不明な企業は推測せず除外されます。

企業全体

Key	Meaning
`cloud_footprint_host_count`	Hosts everywhere
`cloud_footprint_provider_count`	Distinct providers used
`cloud_footprint_country_count`	Countries hosted in
`cloud_footprint_cross_border_country_count`	Countries outside the home market
`cloud_footprint_providers`	Uses any of these providers
`cloud_footprint_primary_provider`	Largest provider is one of these

cloud_footprint_ 接頭辞付きのキーは、目の前の行ではなく企業の全行を通じた状態を表します。企業を絞り込みつつ、その企業の全行を表示したい場合に使います。

ページングと並び順

per_page、page、is_ascending_order は他の検索と同じです。行は last_seen_at の新しい順に並びます。

行の例

{
  "cloud_footprint_id": "b8fcf5c3-a309-4052-ae8f-fe5706051617",
  "domain_search_id": "db26de04-4131-493a-904b-2c7fda2873ee",
  "provider": "Azure",
  "country_code": "NL",
  "company_country_code": "DK",
  "is_home_market": false,
  "host_count": 437,
  "server_count": 8,
  "shared_server_count": 0,
  "region_count": 1,
  "city_count": 0,
  "cloud_regions": ["westeurope"],
  "cities": null,
  "first_seen_at": "2026-07-27T06:59:38.260Z",
  "last_seen_at": "2026-09-04T12:43:28.724Z",
  "evidence_url": "https://www.pubrio.com/evidence/e458a89952ed1e39e977794327939397",
  "companies": {
    "domain_search_id": "db26de04-4131-493a-904b-2c7fda2873ee",
    "company_name": "Wonderful Sound for All - WSA",
    "domain": "wsa.com",
    "country_code": "DK",
    "logo_url": "https://buckets.pubrio.com/company-logo/…"
  }
}

これはデンマーク企業がオランダで Azure を使っている例です。company_country_code が DK、country_code が NL なので is_home_market は false になります。evidence_url は行を裏づける Pubrio のページで、拡大シグナルを生まない自国市場では null です。

レシピ

ドイツに進出したばかりの企業
アジアの本格的な AWS 利用企業
多くの市場に展開する企業
Pilots worth a call

cURL

curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_locations": ["DE"],
    "first_seen_dates": ["2026-08-01", null],
    "is_cross_border_only": true,
    "host_count": [50, null],
    "per_page": 25
  }'

cURL

curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "providers": ["AWS"],
    "target_locations": ["SG", "JP", "IN"],
    "server_count": [10, null],
    "per_page": 25
  }'

cURL

curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cloud_footprint_country_count": [5, null],
    "target_locations": ["DE"],
    "host_count": [100, null],
    "per_page": 25
  }'

各行の domain_search_id は、5 か国以上に展開し、かつこの国で実運用規模を持つ企業です。

cURL

curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "is_cross_border_only": true,
    "first_seen_dates": ["2026-08-01", null],
    "host_count": [1, 25],
    "per_page": 25
  }'

A small, brand-new footprint in a market the company is not headquartered in — the shape of a proof of concept before it becomes a deployment.

企業単位のビュー

クラウドフットプリント分析は domain_search_id を 1 つ受け取り、その企業の全体像を返します。総数、主要プロバイダー・国・リージョン、新規インフラの週次推移、直近の追加分。企業詳細ページ向けで、一覧作成には検索を使います。

変化を監視する

クラウドフットプリントの変化は拡大シグナルとして現れるため、モニターで webhook やメールに随時通知できます。DNS がクラウドフットプリントのシグナルタイプです。

{
  "signal_types": ["expansions"],
  "signal_filters": [
    { "signal_type": "expansions", "filters": { "tos": ["DE"], "signal_types": ["DNS"], "window_days": 30 } }
  ]
}

配信には必ず evidence_url が含まれ、基盤の生データが含まれることはありません。webhook の設定を参照。

知っておくべき点

2 か国で稼働する企業は両方の国別内訳に計上されるため、内訳の合計が総数を上回ることがあります。二重計上ではなく市場ごとの事実です。
本社所在地が不明な企業では is_cross_border は null になります。国内という意味ではなく「不明」です。
範囲は [min, max] で指定し、いずれの端も null で開放できます。
企業検索では cloud_footprint_country_activity が範囲条件を 1 か国に限定します（{"country":"DE","host_count":[100,null]}）。単体の cloud_footprint_host_count は企業合計なので、これは表現できません。