Skip to main content
POST
Buscar la huella cloud de empresas

Autorizaciones

pubrio-api-key
string
header
requerido

Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección Configuración.

Cuerpo

application/json
providers
string[]

Limita los resultados a las filas que coincidan con proveedores cloud o de hosting. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
exclude_providers
string[]

Excluye las filas que coincidan con proveedores cloud o de hosting. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
target_locations
string[]

Códigos de país a los que deben dirigirse los resultados. Se combina con filter_conditions como OR por defecto: basta con que coincida uno.

Ejemplo:
exclude_target_locations
string[]

Códigos de país a los que no deben dirigirse los resultados. Se combina con filter_conditions como OR por defecto: basta con que coincida uno.

Ejemplo:
cloud_regions
string[]

Limita los resultados a las filas que coincidan con regiones cloud. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
exclude_cloud_regions
string[]

Excluye las filas que coincidan con regiones cloud. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
cities
string[]

Limita los resultados a las filas que coincidan con ciudades. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
exclude_cities
string[]

Excluye las filas que coincidan con ciudades. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
first_seen_dates
(string | null)[]

Dos fechas ISO 8601 (AAAA-MM-DD) que acotan cuándo se detectó por primera vez la huella. Limitado a esta fila de huella: un proveedor en un país.

Required array length: 2 elements
Ejemplo:
last_seen_dates
(string | null)[]

Dos fechas ISO 8601 (AAAA-MM-DD) que acotan cuándo se detectó por última vez la huella. Limitado a esta fila de huella: un proveedor en un país.

Required array length: 2 elements
Ejemplo:
is_cross_border_only
boolean

Si es true, devuelve solo filas fuera del mercado de origen de la empresa. Se excluyen las empresas sin sede conocida.

Ejemplo:

true

host_count
(integer | null)[]

Mínimo y máximo de hosts. Usa null para dejar un extremo abierto. Limitado a esta fila de huella: un proveedor en un país.

Required array length: 2 elements
Ejemplo:
server_count
(integer | null)[]

Mínimo y máximo de servidores (IP distintas). Usa null para dejar un extremo abierto. Limitado a esta fila de huella: un proveedor en un país.

Required array length: 2 elements
Ejemplo:
shared_server_count
(integer | null)[]

Mínimo y máximo de servidores compartidos con otras empresas. Usa null para dejar un extremo abierto. Limitado a esta fila de huella: un proveedor en un país.

Required array length: 2 elements
Ejemplo:
region_count
(integer | null)[]

Mínimo y máximo de regiones cloud. Usa null para dejar un extremo abierto. Limitado a esta fila de huella: un proveedor en un país.

Required array length: 2 elements
Ejemplo:
city_count
(integer | null)[]

Mínimo y máximo de ciudades. Usa null para dejar un extremo abierto. Limitado a esta fila de huella: un proveedor en un país.

Required array length: 2 elements
Ejemplo:
cloud_footprint_host_count
(integer | null)[]

Mínimo y máximo de hosts. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_server_count
(integer | null)[]

Mínimo y máximo de servidores (IP distintas). Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_shared_server_count
(integer | null)[]

Mínimo y máximo de servidores compartidos con otras empresas. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_provider_count
(integer | null)[]

Mínimo y máximo de proveedores distintos que usa la empresa. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_country_count
(integer | null)[]

Mínimo y máximo de países donde aloja la empresa. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_cross_border_country_count
(integer | null)[]

Mínimo y máximo de países fuera del mercado de origen. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_region_count
(integer | null)[]

Mínimo y máximo de regiones cloud. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_city_count
(integer | null)[]

Mínimo y máximo de ciudades. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
company_locations
string[]

La ubicación de la sede de la empresa. Consulta los endpoints location en la pestaña Filters para más información.

Ejemplo:
cloud_footprint_id
string<uuid>

Identificador de una fila de huella cloud.

Ejemplo:

"f28215e6-f6ed-40c2-ac9b-d8e70164c0be"

cloud_footprint_ids
string<uuid>[]

Identificadores de filas concretas para exportar una selección.

Ejemplo:
companies
string<uuid>[]

Una lista de identificadores únicos (domain_search_id) utilizada para operaciones de búsqueda de empresas y personas.

domains
string[]

Lista de dominios de empresa utilizada para operaciones de búsqueda de empresas y personas. Si recibimos una URL como www.pubrio.com o https://docs.pubrio.com/, el sistema la convertirá a pubrio.com para su procesamiento.

Ejemplo:
per_page
integer
predeterminado:25

Registros por página. Por defecto es 25, que también es el límite en la mayoría de los planes — el límite es el max_search_per_page de tu suscripción, devuelto por Perfil. Superarlo devuelve HTTP 416 con el código 41676 (o 41613 en la búsqueda de empresas y personas), no un conjunto de resultados recortado.

Rango requerido: x <= 25
Ejemplo:

25

page
integer
predeterminado:1

Número de página, empezando en 1. El límite es el max_search_page de tu suscripción (max_company_search_page para la búsqueda de empresas), devuelto por Perfil. Superarlo devuelve HTTP 416.

Ejemplo:

1

is_ascending_order
boolean
predeterminado:false

Dirección de ordenación. Los resultados se devuelven por defecto de más reciente a más antiguo; establece true para el orden inverso (de más antiguo a más reciente). No existe sort_by en este endpoint: la clave de ordenación es fija y se indica en la descripción del endpoint.

Ejemplo:

false

cloud_footprint_providers
string[]

Empresas que usan alguno de estos proveedores en cualquier lugar. providers sin prefijo acota las filas; este acota las empresas.

Ejemplo:
cloud_footprint_target_locations
string[]

Empresas presentes en alguno de estos países en cualquier parte de su huella.

Ejemplo:
cloud_footprint_primary_provider
string[]

Empresas cuyo mayor proveedor es uno de estos.

Ejemplo:
domain
string

Un dominio de empresa utilizado para operaciones de búsqueda de empresas. Si recibimos una URL como www.pubrio.com o https://docs.pubrio.com/, el sistema la convertirá a pubrio.com para su procesamiento.

Ejemplo:

"pubrio.com"

domain_search_id
string<uuid>

Identificador único para la operación de búsqueda de empresas.

linkedin_urls
string[]

La URL completa del perfil de LinkedIn de la empresa. La URL debe empezar por http y contener linkedin.com/company/

Ejemplo:
filter_conditions
object[]

Cambia un filtro de array de OR (por defecto: coincide con cualquier valor) a AND (coincide con todos). Se aplica a cloud_regions, exclude_cloud_regions, cities y exclude_cities.

Respuesta

Filas de huella cloud paginadas.

The response is of type object.

Última modificación el 4 de septiembre de 2026