curl --request POST \
--url https://api.pubrio.com/companies/advertisements/lookup \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"is_include_unlinked_companies": true
}
'import requests
url = "https://api.pubrio.com/companies/advertisements/lookup"
payload = {
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"is_include_unlinked_companies": True
}
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({
advertisement_search_id: 'a92643e8-9033-4029-aa65-ef929327cebb',
is_include_unlinked_companies: true
})
};
fetch('https://api.pubrio.com/companies/advertisements/lookup', 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/lookup",
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([
'advertisement_search_id' => 'a92643e8-9033-4029-aa65-ef929327cebb',
'is_include_unlinked_companies' => true
]),
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/lookup"
payload := strings.NewReader("{\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"is_include_unlinked_companies\": true\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/lookup")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"is_include_unlinked_companies\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/companies/advertisements/lookup")
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 \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"is_include_unlinked_companies\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"headline": "Thuraya-4 Satellite Solutions for Government",
"description": "Thuraya-4 provides secure, always-on connectivity for vehicles, aircraft and command centers, ensuring mission continuity. \n\nLearn more about our satellite-powered government solutions.",
"poster": "Space42",
"poster_title": "Promoted",
"promoted_by": null,
"cta": "Learn more",
"target_country_codes": [
"MM",
"..."
],
"target_locations": [
"United Arab Emirates",
"..."
],
"total_impressions": "10k-20k",
"impression_countries": [
{
"country": "India",
"impressions": "19%"
},
"..."
],
"advertisement_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"created_at": "2026-03-03T01:01:31.134Z",
"last_modified": "2026-03-03T13:01:22.805Z",
"started_at": "2026-02-25T00:00:00.000Z",
"ended_at": "2026-03-02T00:00:00.000Z",
"title": "Thuraya-4 Satellite Solutions for Government",
"source_type": "linkedin",
"advertisement_format": "Single Image Ad",
"video_url": null,
"image_url": "https://buckets.pubrio.com/images/public/qDf8TrjHJw9o8xFoQJv7vhnkLXNYKy1ThNVCWSHPmgHG5j7U4EroKtH4cYJcHCzTSh.jpg",
"carousel_images": null,
"destination_url": "https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content",
"companies": {
"logo_url": "https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg",
"domain_search_id": "fe3963dc-87a4-4016-8c95-217ea68cd57a",
"company_name": "Space42",
"linkedin_name": "space42ai",
"country_code": "AE",
"domain": "space42.ai"
},
"raw_link_url": null,
"publisher_platforms": null
}
}{
"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."
}Consulta de anuncios de la empresa
Obtén los detalles de un anuncio de una empresa específica usando un ID de búsqueda de anuncios. La respuesta incluye la destination_url resuelta, la raw_link_url original y, para anuncios de Meta, publisher_platforms.
curl --request POST \
--url https://api.pubrio.com/companies/advertisements/lookup \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"is_include_unlinked_companies": true
}
'import requests
url = "https://api.pubrio.com/companies/advertisements/lookup"
payload = {
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"is_include_unlinked_companies": True
}
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({
advertisement_search_id: 'a92643e8-9033-4029-aa65-ef929327cebb',
is_include_unlinked_companies: true
})
};
fetch('https://api.pubrio.com/companies/advertisements/lookup', 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/lookup",
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([
'advertisement_search_id' => 'a92643e8-9033-4029-aa65-ef929327cebb',
'is_include_unlinked_companies' => true
]),
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/lookup"
payload := strings.NewReader("{\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"is_include_unlinked_companies\": true\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/lookup")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"is_include_unlinked_companies\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/companies/advertisements/lookup")
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 \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"is_include_unlinked_companies\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"headline": "Thuraya-4 Satellite Solutions for Government",
"description": "Thuraya-4 provides secure, always-on connectivity for vehicles, aircraft and command centers, ensuring mission continuity. \n\nLearn more about our satellite-powered government solutions.",
"poster": "Space42",
"poster_title": "Promoted",
"promoted_by": null,
"cta": "Learn more",
"target_country_codes": [
"MM",
"..."
],
"target_locations": [
"United Arab Emirates",
"..."
],
"total_impressions": "10k-20k",
"impression_countries": [
{
"country": "India",
"impressions": "19%"
},
"..."
],
"advertisement_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"created_at": "2026-03-03T01:01:31.134Z",
"last_modified": "2026-03-03T13:01:22.805Z",
"started_at": "2026-02-25T00:00:00.000Z",
"ended_at": "2026-03-02T00:00:00.000Z",
"title": "Thuraya-4 Satellite Solutions for Government",
"source_type": "linkedin",
"advertisement_format": "Single Image Ad",
"video_url": null,
"image_url": "https://buckets.pubrio.com/images/public/qDf8TrjHJw9o8xFoQJv7vhnkLXNYKy1ThNVCWSHPmgHG5j7U4EroKtH4cYJcHCzTSh.jpg",
"carousel_images": null,
"destination_url": "https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content",
"companies": {
"logo_url": "https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg",
"domain_search_id": "fe3963dc-87a4-4016-8c95-217ea68cd57a",
"company_name": "Space42",
"linkedin_name": "space42ai",
"country_code": "AE",
"domain": "space42.ai"
},
"raw_link_url": null,
"publisher_platforms": null
}
}{
"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."
}Autorizaciones
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
Identificador único para el resultado de búsqueda de anuncios. Se usa para referenciar anuncios específicos devueltos por el endpoint de búsqueda de anuncios.
"a92643e8-9033-4029-aa65-ef929327cebb"
Incluye anuncios aún no vinculados a una empresa resuelta (anuncios de capa bruta, por ejemplo, anuncios fraudulentos o de páginas desechables). Por defecto es false, lo que devuelve únicamente anuncios atribuidos a una empresa.
true
Respuesta
Respuesta exitosa que contiene los detalles de anuncios de la empresa.
La información de la respuesta depende del endpoint específico.

