> ## 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. # Company Cloud Footprint Insights > Aggregate cloud footprint for one company: totals, the leading providers, countries and regions, a weekly series of newly seen infrastructure, and the most recent additions. See the [Cloud Footprint Search guide](/en/developer-guides/search/cloud-footprint-search). ## OpenAPI ````yaml en-openapi POST /companies/cloud_footprints/insights openapi: 3.0.0 info: description: >- The Pubrio API delivers market expansion intelligence — real-time signals that flag when a company enters a new market — alongside the company and people data beneath them. Search, look up, and enrich accounts and contacts, and subscribe to typed, dated movement signals across 200+ markets. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/en/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/en/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: Workspace profile information and usage statistics - name: Enrichment description: Enrich people and company records with detailed B2B data - name: Lookalike description: Find companies similar to a given company - name: Search description: Search for people, companies, jobs, news, and advertisements with filters - name: Lookup description: >- Look up detailed information for specific people, companies, jobs, news, advertisements, and technologies - name: LinkedIn description: Look up people and company data via LinkedIn profile URLs - name: Redeem description: Redeem credits to unlock people contact details (single and batch) - name: Channels description: Manage outreach channel templates (create, update, delete, list) - name: Monitor description: Create and manage data monitors with webhooks, statistics, and processing - name: Filters description: >- Retrieve available filter values for search parameters (technologies, locations, verticals, etc.) - name: API Keys description: List and inspect API request logs and usage analytics for API keys - name: Insights description: Aggregated signal insights for companies (jobs, news, advertisements). - name: Export description: Bulk data exports (credit-gated). - name: Expansion description: >- Company market-expansion intelligence: signals, stages, markets, and exports. externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /companies/cloud_footprints/insights: post: tags: - Insights summary: Cloud footprint insights description: >- Aggregate cloud footprint for one company: totals, the leading providers, countries and regions, a weekly series of newly seen infrastructure, and the most recent additions. See the [Cloud Footprint Search guide](/en/developer-guides/search/cloud-footprint-search). operationId: companies_cloud_footprint_insights parameters: [] requestBody: required: true content: application/json: schema: type: object required: - domain_search_id properties: domain_search_id: $ref: '#/components/schemas/domain_search_id' date_from: $ref: '#/components/schemas/date_from' date_to: $ref: '#/components/schemas/date_to' responses: '200': description: Aggregated cloud footprint for the company. content: application/json: schema: type: object example: data: totals: hosts: 12713 servers: 20403 providers: 15 countries: 18 cross_border_countries: 17 regions: 47 new_hosts: 12713 providers: - key: DigitalOcean hosts: 6085 servers: 11404 countries: 6 - key: AWS hosts: 4077 servers: 6242 countries: 9 - key: Vultr hosts: 958 servers: 1075 countries: 4 countries: - key: US name: United States hosts: 12542 servers: 20152 providers: 14 is_cross_border: false evidence_url: null - key: CA name: Canada hosts: 81 servers: 116 providers: 6 is_cross_border: true evidence_url: >- https://www.pubrio.com/evidence/a773e15a61cdaad85009a0d1cc6e93d2 - key: DE name: Germany hosts: 24 servers: 36 providers: 4 is_cross_border: true evidence_url: >- https://www.pubrio.com/evidence/e6b59784382beb482a6d932c99403b99 regions: - provider: AWS region_code: us-east-1 region_name: N. Virginia city: Ashburn country_code: US hosts: 1953 servers: 2989 - provider: AWS region_code: us-east-2 region_name: Ohio city: Columbus country_code: US hosts: 1426 servers: 2173 - provider: AWS region_code: us-west-2 region_name: Oregon city: Portland country_code: US hosts: 587 servers: 944 weekly_series: - week_start: '2026-07-20' count: 40 - week_start: '2026-07-27' count: 2547 - week_start: '2026-08-03' count: 2621 - week_start: '2026-08-10' count: 2781 recent_hosts: - provider: AWS country_code: US cloud_region: us-east-1 city: null first_seen_at: '2026-09-04T05:53:40.173866' last_seen_at: '2026-09-04T05:53:40.173866' is_cross_border: false - provider: DigitalOcean country_code: US cloud_region: null city: Clifton first_seen_at: '2026-09-04T05:45:51.263133' last_seen_at: '2026-09-04T05:45:51.263133' is_cross_border: false - provider: DigitalOcean country_code: US cloud_region: null city: Clifton first_seen_at: '2026-09-04T05:45:51.263133' last_seen_at: '2026-09-04T05:45:51.263133' is_cross_border: false window_days: 90 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: domain_search_id: type: string format: uuid description: A unique identifier for the company search operation. date_from: type: string format: date example: '2026-01-01' description: >- Start of the date window (ISO 8601, YYYY-MM-DD). Use together with `date_to` to scope results to a specific range; omit both to use the default window. date_to: type: string format: date example: '2026-03-31' description: >- End of the date window (ISO 8601, YYYY-MM-DD). Must be on or after `date_from`. responses: general_error: description: >- Bad request. The request was malformed or contained invalid parameters. Check the error code and message for details. 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: >- Rate limit exceeded. Too many requests were made in a given time period. Retry after the rate limit window resets. 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: >- Internal server error. An unexpected error occurred on the server. Contact support if the error persists. 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: >- A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the [Settings](https://dashboard.pubrio.com/#/settings/) section. in: header ````