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)[]

풋프린트가 처음 확인된 시점을 한정하는 두 개의 ISO 8601 날짜(YYYY-MM-DD). 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다.

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

풋프린트가 마지막으로 확인된 시점을 한정하는 두 개의 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[]

회사 본사 위치입니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참고하세요.

예시:
cloud_footprint_id
string<uuid>

단일 클라우드 풋프린트 행의 식별자.

예시:

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

cloud_footprint_ids
string<uuid>[]

내보낼 특정 클라우드 풋프린트 행의 식별자.

예시:
companies
string<uuid>[]

회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록.

domains
string[]

회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 www.pubrio.com 또는 https://docs.pubrio.com/인 경우, 시스템은 이를 자동으로 pubrio.com으로 변환하여 처리합니다.

예시:
per_page
integer
기본값:25

페이지당 레코드 수입니다. 기본값은 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.com 또는 https://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_regions, exclude_cloud_regions, cities, exclude_cities에 적용됩니다.

응답

페이지네이션된 클라우드 풋프린트 행.

The response is of type object.

마지막 수정일 2026년 9월 4일