> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.
# クラウドフットプリント検索
> 企業がどのクラウド・ホスティングを、どの国とリージョンで使っているかを把握し、新たに進出した市場を見つけます。
[クラウドフットプリント検索](/jp/api-reference/endpoint/companies/cloud_footprints_search) は「1 社 × 1 プロバイダー × 1 か国」で 1 行を返します。ドイツで AWS、シンガポールで Cloudflare を使う企業は 2 行になります。各行には、その拠点の規模、関係するクラウドリージョンと都市、初回と直近の観測時期が含まれます。
```bash cURL theme={null}
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` の新しい順に並びます。
## 行の例
```json theme={null}
{
"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` です。
## レシピ
```bash cURL theme={null}
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
}'
```
```bash cURL theme={null}
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
}'
```
```bash cURL theme={null}
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 か国以上に展開し、かつこの国で実運用規模を持つ企業です。
```bash cURL theme={null}
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.
## 企業単位のビュー
[クラウドフットプリント分析](/jp/api-reference/endpoint/companies/cloud_footprints_insights) は `domain_search_id` を 1 つ受け取り、その企業の全体像を返します。総数、主要プロバイダー・国・リージョン、新規インフラの週次推移、直近の追加分。企業詳細ページ向けで、一覧作成には検索を使います。
## 変化を監視する
クラウドフットプリントの変化は拡大シグナルとして現れるため、モニターで webhook やメールに随時通知できます。`DNS` がクラウドフットプリントのシグナルタイプです。
```json theme={null}
{
"signal_types": ["expansions"],
"signal_filters": [
{ "signal_type": "expansions", "filters": { "tos": ["DE"], "signal_types": ["DNS"], "window_days": 30 } }
]
}
```
配信には必ず `evidence_url` が含まれ、基盤の生データが含まれることはありません。[webhook の設定](/jp/developer-guides/setting-up-webhooks)を参照。
## 知っておくべき点
* 2 か国で稼働する企業は両方の国別内訳に計上されるため、内訳の合計が総数を上回ることがあります。二重計上ではなく市場ごとの事実です。
* 本社所在地が不明な企業では `is_cross_border` は `null` になります。国内という意味ではなく「不明」です。
* 範囲は `[min, max]` で指定し、いずれの端も `null` で開放できます。
* 企業検索では `cloud_footprint_country_activity` が範囲条件を 1 か国に限定します（`{"country":"DE","host_count":[100,null]}`）。単体の `cloud_footprint_host_count` は企業合計なので、これは表現できません。
## 関連
全パラメーターとレスポンスフィールド。
1 社の総数・プロバイダー・リージョン・週次変化。
企業検索でクラウドフットプリントから企業を探す。
クラウドフットプリントの変化を webhook やメールに送る。