curl --request POST \
--url https://api.pubrio.com/companies/cloud_footprints/insights \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"date_from": "2026-01-01",
"date_to": "2026-03-31"
}
'import requests
url = "https://api.pubrio.com/companies/cloud_footprints/insights"
payload = {
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"date_from": "2026-01-01",
"date_to": "2026-03-31"
}
headers = {
"pubrio-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
domain_search_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
date_from: '2026-01-01',
date_to: '2026-03-31'
})
};
fetch('https://api.pubrio.com/companies/cloud_footprints/insights', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pubrio.com/companies/cloud_footprints/insights",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'domain_search_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'date_from' => '2026-01-01',
'date_to' => '2026-03-31'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"pubrio-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pubrio.com/companies/cloud_footprints/insights"
payload := strings.NewReader("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"date_from\": \"2026-01-01\",\n \"date_to\": \"2026-03-31\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("pubrio-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.pubrio.com/companies/cloud_footprints/insights")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"date_from\": \"2026-01-01\",\n \"date_to\": \"2026-03-31\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/companies/cloud_footprints/insights")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"date_from\": \"2026-01-01\",\n \"date_to\": \"2026-03-31\"\n}"
response = http.request(request)
puts response.read_body{
"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
}
}{
"code": 40001,
"message": "Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações.",
"details": {}
}{
"error": "Limite de requisições excedido. Aguarde e tente novamente mais tarde."
}{
"error": "Ocorreu um erro inesperado no servidor."
}Insights de Pegada Cloud de Empresas
Pegada cloud agregada de uma empresa: totais, principais fornecedores, países e regiões, série semanal de nova infraestrutura e as adições mais recentes. Consulte o guia de pesquisa de pegada cloud.
curl --request POST \
--url https://api.pubrio.com/companies/cloud_footprints/insights \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"date_from": "2026-01-01",
"date_to": "2026-03-31"
}
'import requests
url = "https://api.pubrio.com/companies/cloud_footprints/insights"
payload = {
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"date_from": "2026-01-01",
"date_to": "2026-03-31"
}
headers = {
"pubrio-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
domain_search_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
date_from: '2026-01-01',
date_to: '2026-03-31'
})
};
fetch('https://api.pubrio.com/companies/cloud_footprints/insights', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pubrio.com/companies/cloud_footprints/insights",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'domain_search_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'date_from' => '2026-01-01',
'date_to' => '2026-03-31'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"pubrio-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pubrio.com/companies/cloud_footprints/insights"
payload := strings.NewReader("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"date_from\": \"2026-01-01\",\n \"date_to\": \"2026-03-31\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("pubrio-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.pubrio.com/companies/cloud_footprints/insights")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"date_from\": \"2026-01-01\",\n \"date_to\": \"2026-03-31\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/companies/cloud_footprints/insights")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"date_from\": \"2026-01-01\",\n \"date_to\": \"2026-03-31\"\n}"
response = http.request(request)
puts response.read_body{
"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
}
}{
"code": 40001,
"message": "Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações.",
"details": {}
}{
"error": "Limite de requisições excedido. Aguarde e tente novamente mais tarde."
}{
"error": "Ocorreu um erro inesperado no servidor."
}Autorizações
Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção Configurações.
Corpo
Um identificador único para a operação de busca de empresas.
Início da janela de datas (ISO 8601, AAAA-MM-DD). Use junto com date_to para restringir os resultados a um intervalo específico; omita ambos para usar a janela padrão.
"2026-01-01"
Fim da janela de datas (ISO 8601, AAAA-MM-DD). Deve ser igual ou posterior a date_from.
"2026-03-31"
Resposta
Pegada cloud agregada da empresa.
The response is of type object.

