> ## 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. # Поиск облачного следа компаний > Поиск по публичной облачной и хостинговой инфраструктуре компаний: какие провайдеры, страны и регионы они используют. Одна запись — одна компания у одного провайдера в одной стране. См. [руководство по поиску облачного следа](/ru/developer-guides/search/cloud-footprint-search). ## OpenAPI ````yaml ru-openapi POST /companies/cloud_footprints/search openapi: 3.0.0 info: description: >- API Pubrio предоставляет данные об экспансии на рынки — сигналы в реальном времени, отмечающие выход компании на новый рынок, — вместе с лежащими в их основе данными о компаниях и людях. Выполняйте поиск, просмотр и обогащение данных об аккаунтах и контактах, а также подписывайтесь на типизированные сигналы движения с указанием даты по более чем 200 рынкам. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ru/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ru/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: Просмотр данных о людях и компаниях по URL профиля LinkedIn - name: Redeem description: >- Погашение кредитов для получения контактных данных людей (по одному и пакетно) - name: Channels description: >- Управление шаблонами каналов для рассылок (создание, обновление, удаление, список) - name: Monitor description: >- Создание мониторов данных и управление ими с вебхуками, статистикой и обработкой - name: Filters description: >- Получение доступных значений фильтров для параметров поиска (технологии, местоположения, отрасли и т. д.) - name: API Keys description: >- Просмотр списка и анализ журналов запросов API и статистики использования ключей API - name: Insights description: Агрегированные данные по сигналам компаний (вакансии, новости, реклама). - name: Export description: Массовый экспорт данных (расходует кредиты). - name: Expansion description: 'Данные об экспансии компаний на рынки: сигналы, стадии, рынки и экспорт.' externalDocs: description: >- API Pubrio используется для поиска, предварительного просмотра и обогащения контактов и аккаунтов. База данных Pubrio предоставляет обширные B2B-контакты и данные для анализа продаж. url: https://docs.pubrio.com paths: /companies/cloud_footprints/search: post: tags: - Search summary: Поиск облачного следа компаний description: >- Поиск по публичной облачной и хостинговой инфраструктуре компаний: какие провайдеры, страны и регионы они используют. Одна запись — одна компания у одного провайдера в одной стране. См. [руководство по поиску облачного следа](/ru/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: >- Оставить только записи, соответствующие этим облачные или хостинг-провайдеры. Только в пределах этой записи следа — один провайдер, одна страна. exclude_providers: type: array items: type: string example: - AWS - Cloudflare - Hetzner description: >- Исключить записи, соответствующие этим облачные или хостинг-провайдеры. Только в пределах этой записи следа — один провайдер, одна страна. 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: >- Оставить только записи, соответствующие этим облачные регионы. Только в пределах этой записи следа — один провайдер, одна страна. exclude_cloud_regions: type: array items: type: string example: - us-east-1 - eu-central-1 description: >- Исключить записи, соответствующие этим облачные регионы. Только в пределах этой записи следа — один провайдер, одна страна. cities: type: array items: type: string example: - Ashburn - Frankfurt description: >- Оставить только записи, соответствующие этим города. Только в пределах этой записи следа — один провайдер, одна страна. exclude_cities: type: array items: type: string example: - Ashburn - Frankfurt description: >- Исключить записи, соответствующие этим города. Только в пределах этой записи следа — один провайдер, одна страна. first_seen_dates: type: array items: type: string nullable: true minItems: 2 maxItems: 2 example: - '2026-01-01' - null description: >- Две даты в формате ISO 8601 (ГГГГ-ММ-ДД), ограничивающие период, когда след был впервые обнаружен. Только в пределах этой записи следа — один провайдер, одна страна. last_seen_dates: type: array items: type: string nullable: true minItems: 2 maxItems: 2 example: - '2026-01-01' - null description: >- Две даты в формате ISO 8601 (ГГГГ-ММ-ДД), ограничивающие период, когда след был обнаружен в последний раз. Только в пределах этой записи следа — один провайдер, одна страна. 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`, чтобы не задавать границу. Только в пределах этой записи следа — один провайдер, одна страна. server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Минимум и максимум для серверов (уникальных IP). Используйте `null`, чтобы не задавать границу. Только в пределах этой записи следа — один провайдер, одна страна. shared_server_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Минимум и максимум для серверов, общих с другими компаниями. Используйте `null`, чтобы не задавать границу. Только в пределах этой записи следа — один провайдер, одна страна. region_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Минимум и максимум для облачных регионов. Используйте `null`, чтобы не задавать границу. Только в пределах этой записи следа — один провайдер, одна страна. city_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Минимум и максимум для городов. Используйте `null`, чтобы не задавать границу. Только в пределах этой записи следа — один провайдер, одна страна. 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` на вкладке Filters. 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: >- Список доменов компаний, используемых для операций поиска компаний и людей. Если получен URL вида `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](/en/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](/en/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: >- Домен компании, используемый для операций поиска компаний. Если получен URL вида `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: >- Полностью сформированный URL профиля компании в 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: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Превышен лимит запросов. За заданный период времени было сделано слишком много запросов. Повторите попытку после сброса окна лимита запросов. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Внутренняя ошибка сервера. На сервере произошла непредвиденная ошибка. Если ошибка повторяется, обратитесь в службу поддержки. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````