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",
"profile_id": 123,
"is_include_unlinked_companies": true
}
'import requests
url = "https://api.pubrio.com/companies/advertisements/lookup"
payload = {
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"profile_id": 123,
"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',
profile_id: 123,
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',
'profile_id' => 123,
'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 \"profile_id\": 123,\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 \"profile_id\": 123,\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 \"profile_id\": 123,\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."
}Company Advertisement Lookup
Retrieve advertisement details for a specific company using an advertisement search ID. The response includes the resolved destination_url, the original raw_link_url, and, for Meta ads, 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",
"profile_id": 123,
"is_include_unlinked_companies": true
}
'import requests
url = "https://api.pubrio.com/companies/advertisements/lookup"
payload = {
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"profile_id": 123,
"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',
profile_id: 123,
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',
'profile_id' => 123,
'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 \"profile_id\": 123,\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 \"profile_id\": 123,\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 \"profile_id\": 123,\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."
}Authorizations
Body
A unique identifier for the advertisement search result. Used to reference specific advertisements returned from the ads search endpoint.
"a92643e8-9033-4029-aa65-ef929327cebb"
Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking.
Check out user details endpoints under the Profile tab for more information.
Include ads not yet linked to a resolved company (raw-layer ads, e.g. scam or burner-page ads). Defaults to false, which returns only company-attributed ads.
true
Response
Successful response containing company advertisement details.
Response info depends on specific endpoint.

