curl --request POST \
--url https://api.pubrio.com/companies/advertisements/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",
"is_include_unlinked_companies": false
}
'import requests
url = "https://api.pubrio.com/companies/advertisements/insights"
payload = {
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"date_from": "2026-01-01",
"date_to": "2026-03-31",
"is_include_unlinked_companies": False
}
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',
is_include_unlinked_companies: false
})
};
fetch('https://api.pubrio.com/companies/advertisements/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/advertisements/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',
'is_include_unlinked_companies' => false
]),
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/advertisements/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 \"is_include_unlinked_companies\": false\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/advertisements/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 \"is_include_unlinked_companies\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/companies/advertisements/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 \"is_include_unlinked_companies\": false\n}"
response = http.request(request)
puts response.read_body{
"data": {
"totals": {
"total": 14,
"launched": 4,
"active": 4,
"markets": 46,
"channels": 2
},
"weekly_series": [
{
"week_start": "2026-05-25",
"count": 4
}
],
"postings": [
{
"r": "10k_50k",
"m": [
"PE",
"KR",
"VE",
"AR"
],
"ch": "facebook",
"fo": "video",
"n": 1
}
],
"placement_mix": [
{
"key": "INSTAGRAM",
"count": 10
}
],
"creatives": [
{
"advertisement_search_id": "29fbc4ec-d9f2-40dc-be00-c96856271f8c",
"image_url": "https://buckets.pubrio.com/images/public/fHaGeJ1EMBzgz2o4TMwgsRptA17BMn8U.jpg",
"headline": null,
"cta": "Learn more",
"advertisement_url": "https://www.facebook.com/ads/library?id=1234567890",
"destination_url": "https://www.instagram.com/youtube",
"advertiser": "YouTube",
"body": "this video lives rent free in our minds",
"format": "image",
"has_video": false
}
],
"reach_tiers": [
{
"slug": "lt_1k",
"label": "< 1K"
},
{
"slug": "1k_10k",
"label": "1K–10K"
},
{
"slug": "10k_50k",
"label": "10K–50K"
},
{
"slug": "50k_100k",
"label": "50K–100K"
},
{
"slug": "100k_500k",
"label": "100K–500K"
}
],
"window_days": 90
}
}{
"code": 40001,
"message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
"details": {}
}{
"error": "Request rate limit exceeded. Please wait and try again later."
}{
"error": "An unexpected error occurred on the server."
}Statistiques publicitaires de l'entreprise
Insights agrégés de signaux publicitaires pour une entreprise sur une fenêtre de dates : comptages de publicités actives et lancées, répartition par canal et emplacement, exemples de créations, portée d’audience sous forme de répartition par palier, et une série temporelle hebdomadaire. La portée est toujours rapportée sous forme de répartition par palier, jamais comme un chiffre unique cumulé.
curl --request POST \
--url https://api.pubrio.com/companies/advertisements/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",
"is_include_unlinked_companies": false
}
'import requests
url = "https://api.pubrio.com/companies/advertisements/insights"
payload = {
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"date_from": "2026-01-01",
"date_to": "2026-03-31",
"is_include_unlinked_companies": False
}
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',
is_include_unlinked_companies: false
})
};
fetch('https://api.pubrio.com/companies/advertisements/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/advertisements/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',
'is_include_unlinked_companies' => false
]),
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/advertisements/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 \"is_include_unlinked_companies\": false\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/advertisements/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 \"is_include_unlinked_companies\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/companies/advertisements/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 \"is_include_unlinked_companies\": false\n}"
response = http.request(request)
puts response.read_body{
"data": {
"totals": {
"total": 14,
"launched": 4,
"active": 4,
"markets": 46,
"channels": 2
},
"weekly_series": [
{
"week_start": "2026-05-25",
"count": 4
}
],
"postings": [
{
"r": "10k_50k",
"m": [
"PE",
"KR",
"VE",
"AR"
],
"ch": "facebook",
"fo": "video",
"n": 1
}
],
"placement_mix": [
{
"key": "INSTAGRAM",
"count": 10
}
],
"creatives": [
{
"advertisement_search_id": "29fbc4ec-d9f2-40dc-be00-c96856271f8c",
"image_url": "https://buckets.pubrio.com/images/public/fHaGeJ1EMBzgz2o4TMwgsRptA17BMn8U.jpg",
"headline": null,
"cta": "Learn more",
"advertisement_url": "https://www.facebook.com/ads/library?id=1234567890",
"destination_url": "https://www.instagram.com/youtube",
"advertiser": "YouTube",
"body": "this video lives rent free in our minds",
"format": "image",
"has_video": false
}
],
"reach_tiers": [
{
"slug": "lt_1k",
"label": "< 1K"
},
{
"slug": "1k_10k",
"label": "1K–10K"
},
{
"slug": "10k_50k",
"label": "10K–50K"
},
{
"slug": "50k_100k",
"label": "50K–100K"
},
{
"slug": "100k_500k",
"label": "100K–500K"
}
],
"window_days": 90
}
}{
"code": 40001,
"message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
"details": {}
}{
"error": "Request rate limit exceeded. Please wait and try again later."
}{
"error": "An unexpected error occurred on the server."
}Autorisations
Corps
Un identifiant unique pour l'opération de recherche d'entreprise.
Début de la fenêtre de dates (ISO 8601, YYYY-MM-DD). À utiliser conjointement avec date_to pour limiter les résultats à une plage spécifique ; omettez les deux pour utiliser la fenêtre par défaut.
"2026-01-01"
Fin de la fenêtre de dates (ISO 8601, YYYY-MM-DD). Doit être postérieure ou égale à date_from.
"2026-03-31"
Inclure les publicités pas encore liées à un profil d'entreprise vérifié.
false
Réponse
Bandes d'insight publicitaire pour l'entreprise et la fenêtre.
Bandes d'insight pour l'entreprise et la fenêtre demandées.
Show child attributes
Show child attributes

