> ## 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.
# Búsqueda de huella cloud
> Consulta en qué proveedores cloud y de hosting opera una empresa, en qué países y regiones, y detecta los mercados en los que acaba de entrar.
[Búsqueda de huella cloud](/es/api-reference/endpoint/companies/cloud_footprints_search) devuelve una fila por empresa, proveedor y país. Una empresa en AWS en Alemania y en Cloudflare en Singapur son dos filas. Cada fila indica cuánto opera allí, qué regiones cloud y ciudades toca, y cuándo se observó por primera y última vez.
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_locations": ["DE"],
"providers": ["AWS"],
"first_seen_dates": ["2026-07-01", null],
"host_count": [100, null],
"per_page": 25
}'
```
## Cuándo usarlo
* **Detectar entrada en un mercado.** `first_seen_dates` muestra empresas cuya infraestructura apareció por primera vez en un país dentro de tu ventana.
* **Cualificar por escala.** `host_count` y `server_count` separan una presencia simbólica de un despliegue real.
* **Segmentar por stack.** `providers` y `cloud_regions` encuentran a todos los que usan una plataforma o región concreta.
* **Detectar expansión.** `is_cross_border_only` devuelve solo la presencia fuera del mercado de origen.
## Acotar a una empresa
| Key | Value |
| ------------------ | --------------------------------------------- |
| `domains` | `["stripe.com"]` |
| `domain` | `"stripe.com"` |
| `linkedin_urls` | `["https://www.linkedin.com/company/stripe"]` |
| `companies` | `["db26de04-…"]` — `domain_search_id` values |
| `domain_search_id` | `"db26de04-…"` |
Se permite buscar sin empresa, y es la forma habitual de construir una lista: por ejemplo `{"target_locations": ["DE"], "providers": ["AWS"]}`.
## Filtros
### Proveedor, región y ciudad
| Key | Example |
| --------------- | -------------------------------- |
| `providers` | `["AWS", "Cloudflare"]` |
| `cloud_regions` | `["eu-central-1", "westeurope"]` |
| `cities` | `["Frankfurt", "Ashburn"]` |
Cada clave acepta una lista y tiene su gemela `exclude_`. `cloud_regions` y `cities` son arrays en la fila, así que también aceptan `filter_conditions` para pasar de OR (cualquiera) a AND (todos).
### Dónde está la infraestructura
| Key | Example |
| ------------------- | -------------- |
| `target_locations` | `["DE", "SG"]` |
| `company_locations` | `["US"]` |
`target_locations` es dónde corre la infraestructura; `company_locations` es dónde está la sede. Las filas en las que difieren son justo las interesantes.
### Tamaño
| Key | Meaning |
| --------------------- | ----------------------------------- |
| `host_count` | Hosts on this row |
| `server_count` | Distinct IP addresses |
| `shared_server_count` | Servers shared with other companies |
| `region_count` | Cloud regions |
| `city_count` | Cities |
Las cinco aceptan `[min, max]`, y `null` deja un extremo abierto. Todas describen solo esta fila: un proveedor en un país.
### Cuándo apareció
| Key | Example |
| ------------------ | ---------------------- |
| `first_seen_dates` | `["2026-07-01", null]` |
| `last_seen_dates` | `[null, "2026-06-30"]` |
Ambas aceptan `[from, to]` en fechas ISO, y `null` abre cualquier extremo. `first_seen_dates` es el filtro de entrada en el mercado; `last_seen_dates` responde a la pregunta opuesta.
### Solo transfronterizo
Pon `is_cross_border_only: true` para quedarte solo con presencia fuera del mercado de origen. Las empresas sin sede conocida se excluyen en lugar de adivinarse.
### La empresa entera
| Key | Meaning |
| -------------------------------------------- | --------------------------------- |
| `cloud_footprint_host_count` | Hosts everywhere |
| `cloud_footprint_provider_count` | Distinct providers used |
| `cloud_footprint_country_count` | Countries hosted in |
| `cloud_footprint_cross_border_country_count` | Countries outside the home market |
| `cloud_footprint_providers` | Uses any of these providers |
| `cloud_footprint_primary_provider` | Largest provider is one of these |
Las claves con prefijo `cloud_footprint_` describen a la empresa en todas sus filas, no la fila que tienes delante. Úsalas para cualificar la empresa sin dejar de ver todas sus filas.
### Paginación y orden
`per_page`, `page` y `is_ascending_order` se comportan como en cualquier búsqueda. Las filas se ordenan por `last_seen_at`, lo observado más recientemente primero.
## Cómo es una fila
```json theme={null}
{
"cloud_footprint_id": "b8fcf5c3-a309-4052-ae8f-fe5706051617",
"domain_search_id": "db26de04-4131-493a-904b-2c7fda2873ee",
"provider": "Azure",
"country_code": "NL",
"company_country_code": "DK",
"is_home_market": false,
"host_count": 437,
"server_count": 8,
"shared_server_count": 0,
"region_count": 1,
"city_count": 0,
"cloud_regions": ["westeurope"],
"cities": null,
"first_seen_at": "2026-07-27T06:59:38.260Z",
"last_seen_at": "2026-09-04T12:43:28.724Z",
"evidence_url": "https://www.pubrio.com/evidence/e458a89952ed1e39e977794327939397",
"companies": {
"domain_search_id": "db26de04-4131-493a-904b-2c7fda2873ee",
"company_name": "Wonderful Sound for All - WSA",
"domain": "wsa.com",
"country_code": "DK",
"logo_url": "https://buckets.pubrio.com/company-logo/…"
}
}
```
Es una empresa danesa operando en Azure en Países Bajos: `company_country_code` es `DK` y `country_code` es `NL`, por eso `is_home_market` es `false`. `evidence_url` es una página de Pubrio que respalda la fila; es `null` para el mercado de origen, que no genera señal de expansión.
## Recetas
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_locations": ["DE"],
"first_seen_dates": ["2026-08-01", null],
"is_cross_border_only": true,
"host_count": [50, null],
"per_page": 25
}'
```
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"providers": ["AWS"],
"target_locations": ["SG", "JP", "IN"],
"server_count": [10, null],
"per_page": 25
}'
```
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"cloud_footprint_country_count": [5, null],
"target_locations": ["DE"],
"host_count": [100, null],
"per_page": 25
}'
```
El `domain_search_id` de cada fila es una empresa que opera en al menos cinco países y con despliegue real en este.
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \
-H "pubrio-api-key: $PUBRIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"is_cross_border_only": true,
"first_seen_dates": ["2026-08-01", null],
"host_count": [1, 25],
"per_page": 25
}'
```
A small, brand-new footprint in a market the company is not headquartered in — the shape of a proof of concept before it becomes a deployment.
## Vista por empresa
[Análisis de huella cloud](/es/api-reference/endpoint/companies/cloud_footprints_insights) recibe un `domain_search_id` y devuelve el panorama completo de esa empresa: totales, principales proveedores, países y regiones, serie semanal de infraestructura nueva y las incorporaciones más recientes. Úsalo para una ficha de empresa; usa la búsqueda para construir listas.
## Vigilar los cambios
Los cambios de huella cloud aparecen como señales de expansión, así que un monitor puede enviarlos a un webhook o por email en cuanto ocurren. `DNS` es el tipo de señal de huella cloud:
```json theme={null}
{
"signal_types": ["expansions"],
"signal_filters": [
{ "signal_type": "expansions", "filters": { "tos": ["DE"], "signal_types": ["DNS"], "window_days": 30 } }
]
}
```
Cada envío incluye `evidence_url`. El detalle bruto de la infraestructura nunca se incluye. Consulta [Configurar webhooks](/es/developer-guides/setting-up-webhooks).
## Conviene saber
* Una empresa que opera en dos países cuenta en ambos desgloses, así que la suma de los desgloses puede superar los totales. Es la verdad por mercado, no doble conteo.
* `is_cross_border` es `null` cuando no se conoce la sede de la empresa: significa desconocido, no nacional.
* Los rangos se indican como `[min, max]` y admiten `null` en cualquier extremo.
* Desde la búsqueda de empresas, `cloud_footprint_country_activity` acota los límites a un país (`{"country":"DE","host_count":[100,null]}`); el `cloud_footprint_host_count` plano es el total de la empresa y no puede expresarlo.
## Relacionado
Todos los parámetros y campos de respuesta.
Totales, proveedores, regiones y cambio semanal de una empresa.
Encuentra empresas por su huella cloud en Búsqueda de empresas.
Envía los cambios de huella cloud a un webhook o email.