> ## 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. # 기업 클라우드 풋프린트 검색 > 기업이 공개적으로 드러내는 클라우드·호스팅 사용 현황을 검색합니다. 어떤 제공업체를 쓰고 어느 국가·리전에 배포했는지. 각 행은 기업 1곳 × 제공업체 1곳 × 국가 1곳입니다. [클라우드 풋프린트 검색 가이드](/ko/developer-guides/search/cloud-footprint-search) 참고. ## OpenAPI ````yaml ko-openapi POST /companies/cloud_footprints/search openapi: 3.0.0 info: description: >- Pubrio API는 마켓 확장 인텔리전스를 제공합니다——기업의 신규 시장 진입을 포착하는 실시간 시그널과 그 기반이 되는 기업·인물 데이터. 계정과 연락처를 검색·조회·보강하고, 200+ 시장에 걸친 유형·날짜가 있는 움직임 시그널을 구독하세요. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ko/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ko/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 워크스페이스 프로필 정보 및 사용량 통계 - name: Enrichment description: 상세한 B2B 데이터로 인물 및 기업 레코드를 보강 - name: Lookalike description: 지정된 기업과 유사한 기업 검색 - name: Search description: 필터를 사용하여 인물, 기업, 채용, 뉴스 및 광고 검색 - name: Lookup description: 특정 인물, 기업, 채용, 뉴스, 광고 및 기술의 상세 정보 조회 - name: LinkedIn description: LinkedIn 프로필 URL을 통한 인물 및 기업 데이터 조회 - name: Redeem description: 크레딧을 사용하여 인물 연락처 정보 잠금 해제 (단건 및 배치) - name: Channels description: 아웃리치 채널 템플릿 관리 (생성, 수정, 삭제, 목록) - name: Monitor description: 웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리 - name: Filters description: 검색 매개변수에 사용 가능한 필터 값 조회 (기술, 지역, 버티컬 등) - name: API Keys description: API 키의 요청 로그 및 사용량 분석 조회 - name: Insights description: 회사의 신호 집계 인사이트(채용, 뉴스, 광고). - name: Export description: 대량 데이터 내보내기(크레딧 차감). - name: Expansion description: '회사 시장 확장 인텔리전스: 신호, 단계, 시장, 내보내기.' externalDocs: description: >- Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B 연락처 및 영업 인텔리전스 데이터를 제공합니다. url: https://docs.pubrio.com paths: /companies/cloud_footprints/search: post: tags: - Search summary: 기업 클라우드 풋프린트 검색 description: >- 기업이 공개적으로 드러내는 클라우드·호스팅 사용 현황을 검색합니다. 어떤 제공업체를 쓰고 어느 국가·리전에 배포했는지. 각 행은 기업 1곳 × 제공업체 1곳 × 국가 1곳입니다. [클라우드 풋프린트 검색 가이드](/ko/developer-guides/search/cloud-footprint-search) 참고. operationId: companies_search_cloud_footprints parameters: [] requestBody: required: true content: application/json: schema: type: object properties: providers: $ref: '#/components/schemas/providers' exclude_providers: $ref: '#/components/schemas/exclude_providers' target_locations: $ref: '#/components/schemas/target_locations' exclude_target_locations: $ref: '#/components/schemas/exclude_target_locations' cloud_regions: $ref: '#/components/schemas/cloud_regions' exclude_cloud_regions: $ref: '#/components/schemas/exclude_cloud_regions' cities: $ref: '#/components/schemas/cities' exclude_cities: $ref: '#/components/schemas/exclude_cities' first_seen_dates: $ref: '#/components/schemas/first_seen_dates' last_seen_dates: $ref: '#/components/schemas/last_seen_dates' is_cross_border_only: $ref: '#/components/schemas/is_cross_border_only' host_count: $ref: '#/components/schemas/host_count' server_count: $ref: '#/components/schemas/server_count' shared_server_count: $ref: '#/components/schemas/shared_server_count' region_count: $ref: '#/components/schemas/region_count' city_count: $ref: '#/components/schemas/city_count' cloud_footprint_host_count: $ref: '#/components/schemas/cloud_footprint_host_count' cloud_footprint_server_count: $ref: '#/components/schemas/cloud_footprint_server_count' cloud_footprint_shared_server_count: $ref: '#/components/schemas/cloud_footprint_shared_server_count' cloud_footprint_provider_count: $ref: '#/components/schemas/cloud_footprint_provider_count' cloud_footprint_country_count: $ref: '#/components/schemas/cloud_footprint_country_count' cloud_footprint_cross_border_country_count: $ref: >- #/components/schemas/cloud_footprint_cross_border_country_count cloud_footprint_region_count: $ref: '#/components/schemas/cloud_footprint_region_count' cloud_footprint_city_count: $ref: '#/components/schemas/cloud_footprint_city_count' company_locations: $ref: '#/components/schemas/company_locations' cloud_footprint_id: $ref: '#/components/schemas/cloud_footprint_id' cloud_footprint_ids: $ref: '#/components/schemas/cloud_footprint_ids' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' cloud_footprint_providers: $ref: '#/components/schemas/cloud_footprint_providers' cloud_footprint_target_locations: $ref: '#/components/schemas/cloud_footprint_target_locations' cloud_footprint_primary_provider: $ref: '#/components/schemas/cloud_footprint_primary_provider' domain: $ref: '#/components/schemas/domain' domain_search_id: $ref: '#/components/schemas/domain_search_id' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' filter_conditions: $ref: '#/components/schemas/cloud_footprint_filter_conditions' responses: '200': description: 페이지네이션된 클라우드 풋프린트 행. content: application/json: schema: type: object example: metadata: profile: null filters: page: 1 per_page: 1 is_cross_border_only: true language: en ignored_fields: [] data: pagination: page: 1 per_page: 1 total_entries: 48700 total_pages: 48700 total_display_pages: 250 is_timeout: false cloud_footprints: - cloud_footprint_id: 042fee02-5121-4f23-a166-69bc48e9dfe8 domain_search_id: 2ebd09b1-3bdf-4bf0-9732-c2ed6a734f77 provider: AWS country_code: US company_country_code: CL is_home_market: false host_count: 232 server_count: 3 shared_server_count: 0 region_count: 1 city_count: 0 cloud_regions: - us-east-1 cities: null first_seen_at: '2026-07-26T16:57:20.362Z' last_seen_at: '2026-09-04T10:07:09.799Z' last_modified: '2026-09-04T10:26:52.183Z' companies: logo_url: >- https://buckets.pubrio.com/company-logo/MTc4ODM0MDY5Nmlsajlzc25qMXJ0aWFwLmNvbWxpbmtlZGluXzQ3Njc2Nzkw.jpg domain_search_id: 2ebd09b1-3bdf-4bf0-9732-c2ed6a734f77 company_name: RTIAP Soluciones Tecnológicas SpA linkedin_name: rtiap country_code: CL company_url: http://www.rtiap.com domain: rtiap.com evidence_url: >- https://www.pubrio.com/evidence/84c941ea04a8fa9ed1bbeabc8ff496a7 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: providers: type: array items: type: string example: - AWS - Cloudflare - Hetzner description: >- 이 클라우드·호스팅 제공업체과(와) 일치하는 풋프린트 행만 반환합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. exclude_providers: type: array items: type: string example: - AWS - Cloudflare - Hetzner description: >- 이 클라우드·호스팅 제공업체과(와) 일치하는 풋프린트 행을 제외합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- 결과가 대상으로 해야 하는 국가 코드. 기본적으로 `filter_conditions`와 OR로 결합되어 하나라도 해당하면 일치합니다. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- 결과가 대상으로 하지 않아야 하는 국가 코드. 기본적으로 `filter_conditions`와 OR로 결합되어 하나라도 해당하면 일치합니다. cloud_regions: type: array items: type: string example: - us-east-1 - eu-central-1 description: 이 클라우드 리전과(와) 일치하는 풋프린트 행만 반환합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. exclude_cloud_regions: type: array items: type: string example: - us-east-1 - eu-central-1 description: 이 클라우드 리전과(와) 일치하는 풋프린트 행을 제외합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. cities: type: array items: type: string example: - Ashburn - Frankfurt description: 이 도시과(와) 일치하는 풋프린트 행만 반환합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. exclude_cities: type: array items: type: string example: - Ashburn - Frankfurt description: 이 도시과(와) 일치하는 풋프린트 행을 제외합니다. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. first_seen_dates: type: array items: type: string nullable: true minItems: 2 maxItems: 2 example: - '2026-01-01' - null description: >- 풋프린트가 처음 확인된 시점을 한정하는 두 개의 ISO 8601 날짜(YYYY-MM-DD). 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. last_seen_dates: type: array items: type: string nullable: true minItems: 2 maxItems: 2 example: - '2026-01-01' - null description: >- 풋프린트가 마지막으로 확인된 시점을 한정하는 두 개의 ISO 8601 날짜(YYYY-MM-DD). 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. is_cross_border_only: type: boolean example: true description: true이면 자국 시장 밖의 풋프린트 행만 반환합니다. 본사가 확인되지 않은 기업의 행은 제외됩니다. host_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 호스트 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 서버 수(고유 IP)의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. shared_server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 타사와 공유하는 서버 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. region_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 클라우드 리전 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. city_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 도시 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 이 풋프린트 행(제공업체 1곳 × 국가 1곳)에 한정됩니다. cloud_footprint_host_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 호스트 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다. cloud_footprint_server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 서버 수(고유 IP)의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다. cloud_footprint_shared_server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 타사와 공유하는 서버 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다. cloud_footprint_provider_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 기업이 사용하는 제공업체 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다. cloud_footprint_country_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 기업이 호스팅하는 국가 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다. cloud_footprint_cross_border_country_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 자국 시장 외 국가 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다. cloud_footprint_region_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 클라우드 리전 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다. cloud_footprint_city_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- 도시 수의 최솟값과 최댓값. 한쪽 경계를 두지 않으려면 `null`을 사용하세요. 모든 제공업체와 국가를 합산한 기업 전체 기준입니다. company_locations: type: array items: type: string example: - US - SG - CN description: 회사 본사 위치입니다. 자세한 내용은 필터 탭의 `location` 엔드포인트를 참고하세요. cloud_footprint_id: type: string format: uuid example: f28215e6-f6ed-40c2-ac9b-d8e70164c0be description: 단일 클라우드 풋프린트 행의 식별자. cloud_footprint_ids: type: array items: type: string format: uuid example: - f28215e6-f6ed-40c2-ac9b-d8e70164c0be description: 내보낼 특정 클라우드 풋프린트 행의 식별자. companies: type: array items: type: string format: uuid description: 회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록. domains: type: array items: type: string example: - pubrio.com description: >- 회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 `www.pubrio.com` 또는 `https://docs.pubrio.com/`인 경우, 시스템은 이를 자동으로 `pubrio.com`으로 변환하여 처리합니다. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- 페이지당 레코드 수입니다. 기본값은 25이며 대부분의 플랜에서 상한이기도 합니다. 이 한도는 구독의 `max_search_per_page`이며 [Profile](/ko/api-reference/endpoint/profile/profile)에서 확인할 수 있습니다. 초과하면 결과가 잘리는 것이 아니라 **HTTP 416**과 코드 `41676`(기업·인물 검색은 `41613`)이 반환됩니다. page: type: integer example: 1 default: 1 description: >- 페이지 번호이며 1부터 시작합니다. 상한은 구독의 `max_search_page`(기업 검색은 `max_company_search_page`)이며 [Profile](/ko/api-reference/endpoint/profile/profile)에서 확인할 수 있습니다. 초과하면 **HTTP 416**이 반환됩니다. is_ascending_order: type: boolean default: false example: false description: >- 정렬 방향입니다. 기본값은 최신순이며 `true`로 설정하면 오래된 순으로 반환합니다. 이 엔드포인트에는 `sort_by`가 없으며, 정렬 키는 고정되어 엔드포인트 설명에 명시되어 있습니다. cloud_footprint_providers: type: array items: type: string example: - AWS - Cloudflare description: 이 제공업체 중 하나라도 어딘가에서 사용하는 기업. 접두사 없는 `providers`는 반환 행을, 이것은 기업을 좁힙니다. cloud_footprint_target_locations: type: array items: type: string example: - DE - SG description: 풋프린트 어디에서든 이 국가들에 존재하는 기업. cloud_footprint_primary_provider: type: array items: type: string example: - AWS description: 가장 큰 제공업체가 이들 중 하나인 기업. domain: type: string example: pubrio.com description: >- 회사 조회 작업에 사용되는 회사 도메인입니다. 입력된 주소가 `www.pubrio.com` 또는 `https://docs.pubrio.com/`인 경우, 시스템은 이를 자동으로 `pubrio.com`으로 변환하여 처리합니다. domain_search_id: type: string format: uuid description: 회사 조회 작업의 고유 식별자. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- LinkedIn 회사 페이지의 전체 URL입니다. `http`로 시작하며 `linkedin.com/company/`를 포함해야 합니다. cloud_footprint_filter_conditions: type: array items: type: object properties: key: type: string enum: - cloud_regions - exclude_cloud_regions - cities - exclude_cities example: cloud_regions description: 연산자를 적용할 배열 필터. operator: type: string enum: - or - and example: and description: '`or`는 나열된 값 중 하나라도 가진 행, `and`는 모두 가진 행에 일치합니다.' description: >- 배열 필터를 OR(기본값: 값 중 하나라도 일치)에서 AND(모든 값 일치)로 전환합니다. `cloud_regions`, `exclude_cloud_regions`, `cities`, `exclude_cities`에 적용됩니다. responses: general_error: description: 잘못된 요청. 요청 형식이 올바르지 않거나 잘못된 매개변수가 포함되어 있습니다. 오류 코드와 메시지를 확인하세요. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요. type: string details: type: object rate_limit_error: description: 요청 속도 제한 초과. 주어진 시간 내에 너무 많은 요청이 전송되었습니다. 속도 제한 창이 재설정된 후 다시 시도하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요. type: string server_error: description: 내부 서버 오류. 서버에서 예기치 않은 오류가 발생했습니다. 오류가 지속되면 지원팀에 문의하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다. in: header ````