Búsqueda de huella cloud

Búsqueda de huella cloud 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.

cURL

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

{
  "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

Quién acaba de entrar en Alemania
Usuarios serios de AWS en Asia
Empresas repartidas por muchos mercados
Pilots worth a call

cURL

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
  }'

cURL

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
  }'

cURL

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.

cURL

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 recibe un domain_search_id y devuelve el panorama completo de esa empresa: totales, principales proveedores, países y regiones, una serie semanal de hosts nuevos, los hosts más recientes y alertas de hosts movidos, clouds nuevos, regiones nuevas y entornos de prueba. Úsalo para una ficha de empresa; usa la búsqueda para construir listas. Consulta la guía de Análisis de huella cloud.

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:

{
  "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.

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

Referencia de Búsqueda de huella cloud

Todos los parámetros y campos de respuesta.

Análisis de huella cloud

Totales, listas principales y alertas de cambios de una empresa.

Filtros de huella cloud

Encuentra empresas por su huella cloud en Búsqueda de empresas.

Configurar webhooks

Envía los cambios de huella cloud a un webhook o email.

Monitor

Búsqueda

Filtros

Personas

Expansión

Cuándo usarlo

Acotar a una empresa

Filtros

Proveedor, región y ciudad

Dónde está la infraestructura

Tamaño

Cuándo apareció

Solo transfronterizo

La empresa entera

Paginación y orden

Cómo es una fila

Recetas

Vista por empresa

Vigilar los cambios

Conviene saber

Relacionado

Referencia de Búsqueda de huella cloud

Análisis de huella cloud

Filtros de huella cloud

Configurar webhooks

​Cuándo usarlo

​Acotar a una empresa

​Filtros

​Proveedor, región y ciudad

​Dónde está la infraestructura

​Tamaño

​Cuándo apareció

​Solo transfronterizo

​La empresa entera

​Paginación y orden

​Cómo es una fila

​Recetas

​Vista por empresa

​Vigilar los cambios

​Conviene saber

​Relacionado

Referencia de Búsqueda de huella cloud

Análisis de huella cloud

Filtros de huella cloud

Configurar webhooks

Cuándo usarlo

Acotar a una empresa

Filtros

Proveedor, región y ciudad

Dónde está la infraestructura

Tamaño

Cuándo apareció

Solo transfronterizo

La empresa entera

Paginación y orden

Cómo es una fila

Recetas

Vista por empresa

Vigilar los cambios

Conviene saber

Relacionado