Skip to main content
POST
企業のクラウドフットプリントを検索

承認

pubrio-api-key
string
header
必須

API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの 設定 画面から発行できます。

ボディ

application/json
providers
string[]

これらのクラウド/ホスティングプロバイダーに一致するフットプリント行のみを返します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

:
exclude_providers
string[]

これらのクラウド/ホスティングプロバイダーに一致するフットプリント行を除外します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

:
target_locations
string[]

結果が対象とする国コード。既定では filter_conditions と OR で結合し、いずれかに該当すれば一致します。

:
exclude_target_locations
string[]

結果が対象としない国コード。既定では filter_conditions と OR で結合し、いずれかに該当すれば一致します。

:
cloud_regions
string[]

これらのクラウドリージョンに一致するフットプリント行のみを返します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

:
exclude_cloud_regions
string[]

これらのクラウドリージョンに一致するフットプリント行を除外します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

:
cities
string[]

これらの都市に一致するフットプリント行のみを返します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

:
exclude_cities
string[]

これらの都市に一致するフットプリント行を除外します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

:
first_seen_dates
(string | null)[]

フットプリントが最初に検出された時期を区切る 2 つの ISO 8601 日付(YYYY-MM-DD)。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

Required array length: 2 elements
:
last_seen_dates
(string | null)[]

フットプリントが最後に検出された時期を区切る 2 つの ISO 8601 日付(YYYY-MM-DD)。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

Required array length: 2 elements
:
is_cross_border_only
boolean

true の場合、自国市場以外のフットプリント行のみを返します。本社所在地が不明な企業の行は除外されます。

:

true

host_count
(integer | null)[]

ホスト数の最小値と最大値。上限または下限を設けない場合は null を使用します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

Required array length: 2 elements
:
server_count
(integer | null)[]

サーバー数(一意の IP)の最小値と最大値。上限または下限を設けない場合は null を使用します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

Required array length: 2 elements
:
shared_server_count
(integer | null)[]

他社と共有するサーバー数の最小値と最大値。上限または下限を設けない場合は null を使用します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

Required array length: 2 elements
:
region_count
(integer | null)[]

クラウドリージョン数の最小値と最大値。上限または下限を設けない場合は null を使用します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

Required array length: 2 elements
:
city_count
(integer | null)[]

都市数の最小値と最大値。上限または下限を設けない場合は null を使用します。 このフットプリント行(1 プロバイダー × 1 か国)に限定されます。

Required array length: 2 elements
:
cloud_footprint_host_count
(integer | null)[]

ホスト数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体(すべてのプロバイダーと国)で集計されます。

Required array length: 2 elements
:
cloud_footprint_server_count
(integer | null)[]

サーバー数(一意の IP)の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体(すべてのプロバイダーと国)で集計されます。

Required array length: 2 elements
:
cloud_footprint_shared_server_count
(integer | null)[]

他社と共有するサーバー数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体(すべてのプロバイダーと国)で集計されます。

Required array length: 2 elements
:
cloud_footprint_provider_count
(integer | null)[]

企業が利用するプロバイダー数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体(すべてのプロバイダーと国)で集計されます。

Required array length: 2 elements
:
cloud_footprint_country_count
(integer | null)[]

企業がホスティングする国数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体(すべてのプロバイダーと国)で集計されます。

Required array length: 2 elements
:
cloud_footprint_cross_border_country_count
(integer | null)[]

自国市場以外の国数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体(すべてのプロバイダーと国)で集計されます。

Required array length: 2 elements
:
cloud_footprint_region_count
(integer | null)[]

クラウドリージョン数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体(すべてのプロバイダーと国)で集計されます。

Required array length: 2 elements
:
cloud_footprint_city_count
(integer | null)[]

都市数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体(すべてのプロバイダーと国)で集計されます。

Required array length: 2 elements
:
company_locations
string[]

企業本社の所在地を示すフィルターです。

:
cloud_footprint_id
string<uuid>

単一のクラウドフットプリント行の識別子。

:

"f28215e6-f6ed-40c2-ac9b-d8e70164c0be"

cloud_footprint_ids
string<uuid>[]

エクスポート対象として選択したクラウドフットプリント行の識別子。

:
companies
string<uuid>[]

企業および人物検索処理で利用する domain_search_id の一覧です。

domains
string[]

企業および人物検索に使用する会社ドメインの一覧です。www や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。

:
per_page
integer
デフォルト:25

1 ページあたりの件数。既定は 25 で、多くのプランではこれが上限でもあります。制限値はサブスクリプションの max_search_per_page で、Profile から取得できます。超過すると結果が丸められるのではなく、HTTP 416 とコード 41676(企業・人物検索では 41613)が返ります。

必須範囲: x <= 25
:

25

page
integer
デフォルト:1

ページ番号(1 から開始)。上限はサブスクリプションの max_search_page(企業検索では max_company_search_page)で、Profile から取得できます。超過すると HTTP 416 が返ります。

:

1

is_ascending_order
boolean
デフォルト:false

並び順です。デフォルトは新しい順で返され、true にすると古い順になります。このエンドポイントに sort_by はなく、ソートキーは固定でエンドポイントの説明に記載しています。

:

false

cloud_footprint_providers
string[]

いずれかのプロバイダーをどこかで利用している企業。接頭辞なしの providers は返る行を、こちらは企業を絞り込みます。

:
cloud_footprint_target_locations
string[]

フットプリントのいずれかでこれらの国に存在する企業。

:
cloud_footprint_primary_provider
string[]

最大のプロバイダーがこれらのいずれかである企業。

:
domain
string

企業ルックアップに使用する会社ドメインです。www.pubrio.comhttps://docs.pubrio.com/ のような値が指定された場合、自動的に pubrio.com に正規化されます。

:

"pubrio.com"

domain_search_id
string<uuid>

企業検索系の処理を紐づけるための一意の識別子です。

linkedin_urls
string[]

企業の LinkedIn 公式ページを指す完全な URL です。値は http で始まり、linkedin.com/company/ を含んでいる必要があります。

:
filter_conditions
object[]

配列フィルターを OR(既定:いずれかに一致)から AND(すべてに一致)へ切り替えます。cloud_regionsexclude_cloud_regionscitiesexclude_cities に適用されます。

レスポンス

ページネーションされたクラウドフットプリント行。

The response is of type object.

最終更新日 2026年9月4日