기업 광고 검색
curl --request POST \
--url https://api.pubrio.com/companies/advertisements/search \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"target_locations": [
"TW",
"AE",
"NO"
],
"exclude_target_locations": [
"IS",
"GB",
"FR",
"IE",
"ES"
],
"search_terms": [
"pubrio"
],
"headlines": [
"ASUS",
"iPhone"
],
"filter_conditions": [
{
"key": "exclude_target_locations",
"operator": "or"
}
],
"start_dates": [
"2025-12-01",
"2025-12-01"
],
"end_dates": [
"2025-12-25",
"2025-12-25"
],
"company_locations": [
"US",
"SG",
"CN"
],
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"domains": [
"pubrio.com"
],
"linkedin_urls": [
"https://www.linkedin.com/company/pubrio"
],
"is_realtime_enrichment": true,
"source_types": [
"linkedin",
"facebook"
],
"enrichment_mode": "latest",
"per_page": 25,
"page": 1,
"profile_id": 123,
"publisher_platforms": [
"facebook",
"instagram"
],
"exclude_publisher_platforms": [
"audience_network"
],
"is_include_unlinked_companies": true
}
'import requests
url = "https://api.pubrio.com/companies/advertisements/search"
payload = {
"target_locations": ["TW", "AE", "NO"],
"exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
"search_terms": ["pubrio"],
"headlines": ["ASUS", "iPhone"],
"filter_conditions": [
{
"key": "exclude_target_locations",
"operator": "or"
}
],
"start_dates": ["2025-12-01", "2025-12-01"],
"end_dates": ["2025-12-25", "2025-12-25"],
"company_locations": ["US", "SG", "CN"],
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"domains": ["pubrio.com"],
"linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
"is_realtime_enrichment": True,
"source_types": ["linkedin", "facebook"],
"enrichment_mode": "latest",
"per_page": 25,
"page": 1,
"profile_id": 123,
"publisher_platforms": ["facebook", "instagram"],
"exclude_publisher_platforms": ["audience_network"],
"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({
target_locations: ['TW', 'AE', 'NO'],
exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
search_terms: ['pubrio'],
headlines: ['ASUS', 'iPhone'],
filter_conditions: [{key: 'exclude_target_locations', operator: 'or'}],
start_dates: ['2025-12-01', '2025-12-01'],
end_dates: ['2025-12-25', '2025-12-25'],
company_locations: ['US', 'SG', 'CN'],
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
domains: ['pubrio.com'],
linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
is_realtime_enrichment: true,
source_types: ['linkedin', 'facebook'],
enrichment_mode: 'latest',
per_page: 25,
page: 1,
profile_id: 123,
publisher_platforms: ['facebook', 'instagram'],
exclude_publisher_platforms: ['audience_network'],
is_include_unlinked_companies: true
})
};
fetch('https://api.pubrio.com/companies/advertisements/search', 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/search",
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([
'target_locations' => [
'TW',
'AE',
'NO'
],
'exclude_target_locations' => [
'IS',
'GB',
'FR',
'IE',
'ES'
],
'search_terms' => [
'pubrio'
],
'headlines' => [
'ASUS',
'iPhone'
],
'filter_conditions' => [
[
'key' => 'exclude_target_locations',
'operator' => 'or'
]
],
'start_dates' => [
'2025-12-01',
'2025-12-01'
],
'end_dates' => [
'2025-12-25',
'2025-12-25'
],
'company_locations' => [
'US',
'SG',
'CN'
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'domains' => [
'pubrio.com'
],
'linkedin_urls' => [
'https://www.linkedin.com/company/pubrio'
],
'is_realtime_enrichment' => true,
'source_types' => [
'linkedin',
'facebook'
],
'enrichment_mode' => 'latest',
'per_page' => 25,
'page' => 1,
'profile_id' => 123,
'publisher_platforms' => [
'facebook',
'instagram'
],
'exclude_publisher_platforms' => [
'audience_network'
],
'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/search"
payload := strings.NewReader("{\n \"target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"search_terms\": [\n \"pubrio\"\n ],\n \"headlines\": [\n \"ASUS\",\n \"iPhone\"\n ],\n \"filter_conditions\": [\n {\n \"key\": \"exclude_target_locations\",\n \"operator\": \"or\"\n }\n ],\n \"start_dates\": [\n \"2025-12-01\",\n \"2025-12-01\"\n ],\n \"end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"profile_id\": 123,\n \"publisher_platforms\": [\n \"facebook\",\n \"instagram\"\n ],\n \"exclude_publisher_platforms\": [\n \"audience_network\"\n ],\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/search")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"search_terms\": [\n \"pubrio\"\n ],\n \"headlines\": [\n \"ASUS\",\n \"iPhone\"\n ],\n \"filter_conditions\": [\n {\n \"key\": \"exclude_target_locations\",\n \"operator\": \"or\"\n }\n ],\n \"start_dates\": [\n \"2025-12-01\",\n \"2025-12-01\"\n ],\n \"end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"profile_id\": 123,\n \"publisher_platforms\": [\n \"facebook\",\n \"instagram\"\n ],\n \"exclude_publisher_platforms\": [\n \"audience_network\"\n ],\n \"is_include_unlinked_companies\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/companies/advertisements/search")
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 \"target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"search_terms\": [\n \"pubrio\"\n ],\n \"headlines\": [\n \"ASUS\",\n \"iPhone\"\n ],\n \"filter_conditions\": [\n {\n \"key\": \"exclude_target_locations\",\n \"operator\": \"or\"\n }\n ],\n \"start_dates\": [\n \"2025-12-01\",\n \"2025-12-01\"\n ],\n \"end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"profile_id\": 123,\n \"publisher_platforms\": [\n \"facebook\",\n \"instagram\"\n ],\n \"exclude_publisher_platforms\": [\n \"audience_network\"\n ],\n \"is_include_unlinked_companies\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"pagination": {
"page": 1,
"per_page": 25,
"total_entries": 694356,
"total_pages": 27775,
"total_display_pages": 250,
"is_timeout": false
},
"advertisements": [
{
"target_country_codes": [
"US",
"GB",
"SG"
],
"advertisement_id": "3af8cb80-9a04-49a8-832d-333961d5f77a",
"advertisement_search_id": "3af8cb80-9a04-49a8-832d-333961d5f77a",
"created_at": "2026-03-03T01:46:35.909Z",
"last_modified": "2026-03-03T12:46:25.289Z",
"started_at": "2026-02-25T00:00:00.000Z",
"ended_at": "2026-03-02T00:00:00.000Z",
"title": "Thuraya-4 Satellite Solutions for Energy",
"source_type": "linkedin",
"advertisement_format": "Single Image Ad",
"video_url": null,
"image_url": "https://buckets.pubrio.com/images/public/cL1U5ghYPAy65qc4cu5wtmgzv8P9xJgrofNTwohPWsyT3S5ob2zNp6Jov1nM9aaDRy.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
},
{
"target_country_codes": [
"US",
"GB",
"SG"
],
"advertisement_id": "47eb6229-e7aa-427f-bcd3-76e154fd5022",
"advertisement_search_id": "47eb6229-e7aa-427f-bcd3-76e154fd5022",
"created_at": "2026-06-03T22:00:33.035Z",
"last_modified": "2026-06-05T18:15:51.823Z",
"started_at": "2026-05-25T07:00:00.000Z",
"ended_at": "2026-06-03T07:00:00.000Z",
"title": "Dubai Opportunities. One Exclusive Event",
"source_type": "facebook",
"advertisement_format": "DCO",
"video_url": null,
"image_url": "https://buckets.pubrio.com/images/public/4snZgJwKCWEYwAUwxrkkK1ooEFEAMF92Xet6Bm16oAyqwUSoqekDjX8S9DmfixutuH.jpg",
"carousel_images": null,
"destination_url": "https://promotions.damacproperties.com/en/event-in-egypt-social-specific/",
"raw_link_url": "http://fb.me/",
"publisher_platforms": [
"facebook",
"instagram"
],
"companies": {
"logo_url": "https://buckets.pubrio.com/company-logo/MjYwODA0MjRkYW1hY3Byb3BlcnRpZXMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
"domain_search_id": "9da7386c-5bdc-42b2-8fee-456e91024a3a",
"company_name": "Damac Properties",
"linkedin_name": "damac-properties",
"country_code": "AE",
"domain": "damacproperties.com"
}
},
"..."
]
}
}{
"code": 40001,
"message": "오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요.",
"details": {}
}{
"error": "요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요."
}{
"error": "요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다"
}검색
기업 광고 검색
지정된 조건에 맞는 기업이 운영하는 광고를 검색합니다. facebook 광고의 경우 source_type 은 Meta 광고 라이브러리 전체(Facebook, Instagram, Messenger, Threads, Audience Network)를 포함하며, publisher_platforms 로 노출 위치별로 좁힐 수 있습니다. destination_url 은 해석된 랜딩 페이지를 반환합니다(fb.me 같은 Facebook 클릭 래퍼는 실제 퍼널 URL로 펼쳐집니다). raw_link_url 은 수집된 원본 링크를 그대로 보존합니다.
POST
/
companies
/
advertisements
/
search
기업 광고 검색
curl --request POST \
--url https://api.pubrio.com/companies/advertisements/search \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"target_locations": [
"TW",
"AE",
"NO"
],
"exclude_target_locations": [
"IS",
"GB",
"FR",
"IE",
"ES"
],
"search_terms": [
"pubrio"
],
"headlines": [
"ASUS",
"iPhone"
],
"filter_conditions": [
{
"key": "exclude_target_locations",
"operator": "or"
}
],
"start_dates": [
"2025-12-01",
"2025-12-01"
],
"end_dates": [
"2025-12-25",
"2025-12-25"
],
"company_locations": [
"US",
"SG",
"CN"
],
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"domains": [
"pubrio.com"
],
"linkedin_urls": [
"https://www.linkedin.com/company/pubrio"
],
"is_realtime_enrichment": true,
"source_types": [
"linkedin",
"facebook"
],
"enrichment_mode": "latest",
"per_page": 25,
"page": 1,
"profile_id": 123,
"publisher_platforms": [
"facebook",
"instagram"
],
"exclude_publisher_platforms": [
"audience_network"
],
"is_include_unlinked_companies": true
}
'import requests
url = "https://api.pubrio.com/companies/advertisements/search"
payload = {
"target_locations": ["TW", "AE", "NO"],
"exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
"search_terms": ["pubrio"],
"headlines": ["ASUS", "iPhone"],
"filter_conditions": [
{
"key": "exclude_target_locations",
"operator": "or"
}
],
"start_dates": ["2025-12-01", "2025-12-01"],
"end_dates": ["2025-12-25", "2025-12-25"],
"company_locations": ["US", "SG", "CN"],
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"domains": ["pubrio.com"],
"linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
"is_realtime_enrichment": True,
"source_types": ["linkedin", "facebook"],
"enrichment_mode": "latest",
"per_page": 25,
"page": 1,
"profile_id": 123,
"publisher_platforms": ["facebook", "instagram"],
"exclude_publisher_platforms": ["audience_network"],
"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({
target_locations: ['TW', 'AE', 'NO'],
exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
search_terms: ['pubrio'],
headlines: ['ASUS', 'iPhone'],
filter_conditions: [{key: 'exclude_target_locations', operator: 'or'}],
start_dates: ['2025-12-01', '2025-12-01'],
end_dates: ['2025-12-25', '2025-12-25'],
company_locations: ['US', 'SG', 'CN'],
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
domains: ['pubrio.com'],
linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
is_realtime_enrichment: true,
source_types: ['linkedin', 'facebook'],
enrichment_mode: 'latest',
per_page: 25,
page: 1,
profile_id: 123,
publisher_platforms: ['facebook', 'instagram'],
exclude_publisher_platforms: ['audience_network'],
is_include_unlinked_companies: true
})
};
fetch('https://api.pubrio.com/companies/advertisements/search', 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/search",
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([
'target_locations' => [
'TW',
'AE',
'NO'
],
'exclude_target_locations' => [
'IS',
'GB',
'FR',
'IE',
'ES'
],
'search_terms' => [
'pubrio'
],
'headlines' => [
'ASUS',
'iPhone'
],
'filter_conditions' => [
[
'key' => 'exclude_target_locations',
'operator' => 'or'
]
],
'start_dates' => [
'2025-12-01',
'2025-12-01'
],
'end_dates' => [
'2025-12-25',
'2025-12-25'
],
'company_locations' => [
'US',
'SG',
'CN'
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'domains' => [
'pubrio.com'
],
'linkedin_urls' => [
'https://www.linkedin.com/company/pubrio'
],
'is_realtime_enrichment' => true,
'source_types' => [
'linkedin',
'facebook'
],
'enrichment_mode' => 'latest',
'per_page' => 25,
'page' => 1,
'profile_id' => 123,
'publisher_platforms' => [
'facebook',
'instagram'
],
'exclude_publisher_platforms' => [
'audience_network'
],
'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/search"
payload := strings.NewReader("{\n \"target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"search_terms\": [\n \"pubrio\"\n ],\n \"headlines\": [\n \"ASUS\",\n \"iPhone\"\n ],\n \"filter_conditions\": [\n {\n \"key\": \"exclude_target_locations\",\n \"operator\": \"or\"\n }\n ],\n \"start_dates\": [\n \"2025-12-01\",\n \"2025-12-01\"\n ],\n \"end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"profile_id\": 123,\n \"publisher_platforms\": [\n \"facebook\",\n \"instagram\"\n ],\n \"exclude_publisher_platforms\": [\n \"audience_network\"\n ],\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/search")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"search_terms\": [\n \"pubrio\"\n ],\n \"headlines\": [\n \"ASUS\",\n \"iPhone\"\n ],\n \"filter_conditions\": [\n {\n \"key\": \"exclude_target_locations\",\n \"operator\": \"or\"\n }\n ],\n \"start_dates\": [\n \"2025-12-01\",\n \"2025-12-01\"\n ],\n \"end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"profile_id\": 123,\n \"publisher_platforms\": [\n \"facebook\",\n \"instagram\"\n ],\n \"exclude_publisher_platforms\": [\n \"audience_network\"\n ],\n \"is_include_unlinked_companies\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/companies/advertisements/search")
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 \"target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"search_terms\": [\n \"pubrio\"\n ],\n \"headlines\": [\n \"ASUS\",\n \"iPhone\"\n ],\n \"filter_conditions\": [\n {\n \"key\": \"exclude_target_locations\",\n \"operator\": \"or\"\n }\n ],\n \"start_dates\": [\n \"2025-12-01\",\n \"2025-12-01\"\n ],\n \"end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"profile_id\": 123,\n \"publisher_platforms\": [\n \"facebook\",\n \"instagram\"\n ],\n \"exclude_publisher_platforms\": [\n \"audience_network\"\n ],\n \"is_include_unlinked_companies\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"pagination": {
"page": 1,
"per_page": 25,
"total_entries": 694356,
"total_pages": 27775,
"total_display_pages": 250,
"is_timeout": false
},
"advertisements": [
{
"target_country_codes": [
"US",
"GB",
"SG"
],
"advertisement_id": "3af8cb80-9a04-49a8-832d-333961d5f77a",
"advertisement_search_id": "3af8cb80-9a04-49a8-832d-333961d5f77a",
"created_at": "2026-03-03T01:46:35.909Z",
"last_modified": "2026-03-03T12:46:25.289Z",
"started_at": "2026-02-25T00:00:00.000Z",
"ended_at": "2026-03-02T00:00:00.000Z",
"title": "Thuraya-4 Satellite Solutions for Energy",
"source_type": "linkedin",
"advertisement_format": "Single Image Ad",
"video_url": null,
"image_url": "https://buckets.pubrio.com/images/public/cL1U5ghYPAy65qc4cu5wtmgzv8P9xJgrofNTwohPWsyT3S5ob2zNp6Jov1nM9aaDRy.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
},
{
"target_country_codes": [
"US",
"GB",
"SG"
],
"advertisement_id": "47eb6229-e7aa-427f-bcd3-76e154fd5022",
"advertisement_search_id": "47eb6229-e7aa-427f-bcd3-76e154fd5022",
"created_at": "2026-06-03T22:00:33.035Z",
"last_modified": "2026-06-05T18:15:51.823Z",
"started_at": "2026-05-25T07:00:00.000Z",
"ended_at": "2026-06-03T07:00:00.000Z",
"title": "Dubai Opportunities. One Exclusive Event",
"source_type": "facebook",
"advertisement_format": "DCO",
"video_url": null,
"image_url": "https://buckets.pubrio.com/images/public/4snZgJwKCWEYwAUwxrkkK1ooEFEAMF92Xet6Bm16oAyqwUSoqekDjX8S9DmfixutuH.jpg",
"carousel_images": null,
"destination_url": "https://promotions.damacproperties.com/en/event-in-egypt-social-specific/",
"raw_link_url": "http://fb.me/",
"publisher_platforms": [
"facebook",
"instagram"
],
"companies": {
"logo_url": "https://buckets.pubrio.com/company-logo/MjYwODA0MjRkYW1hY3Byb3BlcnRpZXMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg",
"domain_search_id": "9da7386c-5bdc-42b2-8fee-456e91024a3a",
"company_name": "Damac Properties",
"linkedin_name": "damac-properties",
"country_code": "AE",
"domain": "damacproperties.com"
}
},
"..."
]
}
}{
"code": 40001,
"message": "오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요.",
"details": {}
}{
"error": "요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요."
}{
"error": "요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다"
}본문
application/json
국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 필터링합니다. 특정 국가에서 표시되는 광고를 찾는 데 사용합니다. filter_conditions와 함께 OR 연산자를 사용합니다 - 광고는 지정된 위치 중 최소 하나를 타겟팅해야 합니다.
예시:
["TW", "AE", "NO"]
국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 제외합니다. 특정 국가에서 표시되는 광고를 필터링하여 제외합니다. filter_conditions에서 'or' 연산자와 함께 지정된 경우, 광고는 제외된 위치 중 어느 곳도 타겟팅하지 않아야 합니다.
예시:
["IS", "GB", "FR", "IE", "ES"]
검색 결과를 필터링하는 키워드 문자열 목록입니다.
예시:
["pubrio"]
검색 결과를 필터링하는 제목 목록입니다.
예시:
["ASUS", "iPhone"]
광고 검색의 고급 필터링 옵션입니다. 광고 검색 엔드포인트의 검색 결과를 개선하기 위한 조건을 지정합니다.
Show child attributes
Show child attributes
검색 결과를 필터링하는 시작 날짜 목록입니다.
예시:
["2025-12-01", "2025-12-01"]
검색 결과를 필터링하는 종료 날짜 목록입니다.
예시:
["2025-12-25", "2025-12-25"]
회사 본사 위치입니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참고하세요.
예시:
["US", "SG", "CN"]
회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록.
회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 www.pubrio.com 또는 https://docs.pubrio.com/인 경우, 시스템은 이를 자동으로 pubrio.com으로 변환하여 처리합니다.
예시:
["pubrio.com"]
LinkedIn 회사 페이지의 전체 URL입니다. http로 시작하며 linkedin.com/company/를 포함해야 합니다.
예시:
["https://www.linkedin.com/company/pubrio"]
단일 회사 범위 쿼리(즉, domain_search_id, domains, 또는 linkedin_urls 로 필터링됨)에서 실시간 보강을 활성화합니다. 초기 검색 결과가 0건일 때 엔드포인트가 소스를 스크랩해 레코드를 저장한 뒤 검색을 다시 실행하고 응답합니다. 라우트별 데드라인이 적용됩니다.
예시:
true
실시간 보강에 사용할 광고 소스 유형을 제한합니다. 생략하면 모든 소스가 기본값으로 사용됩니다. 실시간 보강이 실제로 실행될 때에만 적용됩니다 — 즉, is_realtime_enrichment 또는 enrichment_mode: latest 가 설정된 경우입니다.
사용 가능한 옵션:
linkedin, facebook, google 예시:
["linkedin", "facebook"]
실시간 보강 동작을 제어합니다. default 는 데이터베이스에 이미 있는 데이터를 반환하며, 결과가 비어 있고 is_realtime_enrichment 가 설정된 경우에만 보강을 트리거합니다. latest 는 캐시를 우회하고 호출마다 최신 소스 레코드를 기준으로 재보강을 강제합니다 — 다른 플래그 없이도 latest 자체가 보강을 트리거합니다.
사용 가능한 옵션:
default, latest 예시:
"latest"
페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다.
예시:
25
조회할 데이터 페이지 번호입니다.
예시:
1
선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.
자세한 내용은 팀 탭의 user details 엔드포인트를 참고하세요.
게재된 플랫폼 노출 위치로 Facebook/Meta 광고를 필터링합니다. 소문자이며 대소문자를 구분하지 않습니다. facebook 소스에만 적용됩니다(다른 소스는 단일 플랫폼).
사용 가능한 옵션:
facebook, instagram, messenger, threads, audience_network 예시:
["facebook", "instagram"]
이 플랫폼 노출 위치에서 게재된 Facebook/Meta 광고를 제외합니다.
사용 가능한 옵션:
facebook, instagram, messenger, threads, audience_network 예시:
["audience_network"]
확인된 회사에 아직 연결되지 않은 광고(원시 계층 광고, 예: 사기 또는 일회용 페이지 광고)를 포함합니다. 기본값은 false이며 회사에 연결된 광고만 반환합니다.
예시:
true
응답
회사 광고 검색 세부 정보가 포함된 성공적인 응답입니다.
응답 정보는 특정 API에 따라 다릅니다.
⌘I