企業広告検索
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"
],
"active_dates": [
"2026-08-01",
"2026-08-31"
],
"created_at": "2026-09-02T12:00:00Z",
"company_locations": [
"US",
"SG",
"CN"
],
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"domains": [
"pubrio.com"
],
"linkedin_urls": [
"https://www.linkedin.com/company/pubrio"
],
"is_realtime_enrichment": true,
"advertisement_formats": [
"image",
"video"
],
"reach_tiers": [
"100k_500k",
"500k_1m",
"1m_plus"
],
"advertisement_active_ads": [
1,
null
],
"advertisement_running_ads": [
1,
null
],
"advertisement_total_ads": [
10,
null
],
"advertisement_platform_count": [
2,
null
],
"advertisement_format_count": [
2,
null
],
"advertisement_impressions_estimate": [
1000,
null
],
"advertisement_country_activity": {
"country": "US",
"rank": [
null,
500
]
},
"source_types": [
"linkedin",
"facebook"
],
"exclude_source_types": [
"apple"
],
"enrichment_mode": "latest",
"per_page": 25,
"page": 1,
"is_ascending_order": false,
"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"],
"active_dates": ["2026-08-01", "2026-08-31"],
"created_at": "2026-09-02T12:00:00Z",
"company_locations": ["US", "SG", "CN"],
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"domains": ["pubrio.com"],
"linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
"is_realtime_enrichment": True,
"advertisement_formats": ["image", "video"],
"reach_tiers": ["100k_500k", "500k_1m", "1m_plus"],
"advertisement_active_ads": [1, None],
"advertisement_running_ads": [1, None],
"advertisement_total_ads": [10, None],
"advertisement_platform_count": [2, None],
"advertisement_format_count": [2, None],
"advertisement_impressions_estimate": [1000, None],
"advertisement_country_activity": {
"country": "US",
"rank": [None, 500]
},
"source_types": ["linkedin", "facebook"],
"exclude_source_types": ["apple"],
"enrichment_mode": "latest",
"per_page": 25,
"page": 1,
"is_ascending_order": False,
"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'],
active_dates: ['2026-08-01', '2026-08-31'],
created_at: '2026-09-02T12:00:00Z',
company_locations: ['US', 'SG', 'CN'],
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
advertisement_search_id: 'a92643e8-9033-4029-aa65-ef929327cebb',
domains: ['pubrio.com'],
linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
is_realtime_enrichment: true,
advertisement_formats: ['image', 'video'],
reach_tiers: ['100k_500k', '500k_1m', '1m_plus'],
advertisement_active_ads: [1, null],
advertisement_running_ads: [1, null],
advertisement_total_ads: [10, null],
advertisement_platform_count: [2, null],
advertisement_format_count: [2, null],
advertisement_impressions_estimate: [1000, null],
advertisement_country_activity: {country: 'US', rank: [null, 500]},
source_types: ['linkedin', 'facebook'],
exclude_source_types: ['apple'],
enrichment_mode: 'latest',
per_page: 25,
page: 1,
is_ascending_order: false,
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'
],
'active_dates' => [
'2026-08-01',
'2026-08-31'
],
'created_at' => '2026-09-02T12:00:00Z',
'company_locations' => [
'US',
'SG',
'CN'
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'advertisement_search_id' => 'a92643e8-9033-4029-aa65-ef929327cebb',
'domains' => [
'pubrio.com'
],
'linkedin_urls' => [
'https://www.linkedin.com/company/pubrio'
],
'is_realtime_enrichment' => true,
'advertisement_formats' => [
'image',
'video'
],
'reach_tiers' => [
'100k_500k',
'500k_1m',
'1m_plus'
],
'advertisement_active_ads' => [
1,
null
],
'advertisement_running_ads' => [
1,
null
],
'advertisement_total_ads' => [
10,
null
],
'advertisement_platform_count' => [
2,
null
],
'advertisement_format_count' => [
2,
null
],
'advertisement_impressions_estimate' => [
1000,
null
],
'advertisement_country_activity' => [
'country' => 'US',
'rank' => [
null,
500
]
],
'source_types' => [
'linkedin',
'facebook'
],
'exclude_source_types' => [
'apple'
],
'enrichment_mode' => 'latest',
'per_page' => 25,
'page' => 1,
'is_ascending_order' => false,
'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 \"active_dates\": [\n \"2026-08-01\",\n \"2026-08-31\"\n ],\n \"created_at\": \"2026-09-02T12:00:00Z\",\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"advertisement_formats\": [\n \"image\",\n \"video\"\n ],\n \"reach_tiers\": [\n \"100k_500k\",\n \"500k_1m\",\n \"1m_plus\"\n ],\n \"advertisement_active_ads\": [\n 1,\n null\n ],\n \"advertisement_running_ads\": [\n 1,\n null\n ],\n \"advertisement_total_ads\": [\n 10,\n null\n ],\n \"advertisement_platform_count\": [\n 2,\n null\n ],\n \"advertisement_format_count\": [\n 2,\n null\n ],\n \"advertisement_impressions_estimate\": [\n 1000,\n null\n ],\n \"advertisement_country_activity\": {\n \"country\": \"US\",\n \"rank\": [\n null,\n 500\n ]\n },\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"exclude_source_types\": [\n \"apple\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"is_ascending_order\": false,\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 \"active_dates\": [\n \"2026-08-01\",\n \"2026-08-31\"\n ],\n \"created_at\": \"2026-09-02T12:00:00Z\",\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"advertisement_formats\": [\n \"image\",\n \"video\"\n ],\n \"reach_tiers\": [\n \"100k_500k\",\n \"500k_1m\",\n \"1m_plus\"\n ],\n \"advertisement_active_ads\": [\n 1,\n null\n ],\n \"advertisement_running_ads\": [\n 1,\n null\n ],\n \"advertisement_total_ads\": [\n 10,\n null\n ],\n \"advertisement_platform_count\": [\n 2,\n null\n ],\n \"advertisement_format_count\": [\n 2,\n null\n ],\n \"advertisement_impressions_estimate\": [\n 1000,\n null\n ],\n \"advertisement_country_activity\": {\n \"country\": \"US\",\n \"rank\": [\n null,\n 500\n ]\n },\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"exclude_source_types\": [\n \"apple\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"is_ascending_order\": false,\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 \"active_dates\": [\n \"2026-08-01\",\n \"2026-08-31\"\n ],\n \"created_at\": \"2026-09-02T12:00:00Z\",\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"advertisement_formats\": [\n \"image\",\n \"video\"\n ],\n \"reach_tiers\": [\n \"100k_500k\",\n \"500k_1m\",\n \"1m_plus\"\n ],\n \"advertisement_active_ads\": [\n 1,\n null\n ],\n \"advertisement_running_ads\": [\n 1,\n null\n ],\n \"advertisement_total_ads\": [\n 10,\n null\n ],\n \"advertisement_platform_count\": [\n 2,\n null\n ],\n \"advertisement_format_count\": [\n 2,\n null\n ],\n \"advertisement_impressions_estimate\": [\n 1000,\n null\n ],\n \"advertisement_country_activity\": {\n \"country\": \"US\",\n \"rank\": [\n null,\n 500\n ]\n },\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"exclude_source_types\": [\n \"apple\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"is_ascending_order\": false,\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{
"metadata": {
"profile": null,
"filters": {
"source_types": [
"linkedin"
],
"per_page": 25,
"language": "en"
},
"ignored_fields": [],
"applied_source_types": [
"linkedin"
]
},
"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,
"advertisement_format_normalized": "image",
"is_company_matched": true,
"advertiser": "Thuraya",
"advertiser_url": "https://www.linkedin.com/company/thuraya",
"advertisement_url": "https://www.linkedin.com/ad-library/detail/1518455034",
"total_impressions": "< 1k",
"total_impressions_lower": null,
"total_impressions_upper": 1000
},
{
"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"
},
"advertisement_format_normalized": "image",
"is_company_matched": true,
"advertiser": "Thuraya",
"advertiser_url": "https://www.linkedin.com/company/thuraya",
"advertisement_url": "https://www.linkedin.com/ad-library/detail/1518455034",
"total_impressions": "< 1k",
"total_impressions_lower": null,
"total_impressions_upper": 1000
},
"..."
]
}
}{
"code": 40001,
"message": "エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。",
"details": {}
}{
"error": "クライアントはしばらく待ってから再試行することが推奨されます。"
}{
"error": "レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。"
}検索
企業広告検索
企業が出稿した広告を検索します。広告検索ガイドを参照。
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"
],
"active_dates": [
"2026-08-01",
"2026-08-31"
],
"created_at": "2026-09-02T12:00:00Z",
"company_locations": [
"US",
"SG",
"CN"
],
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"domains": [
"pubrio.com"
],
"linkedin_urls": [
"https://www.linkedin.com/company/pubrio"
],
"is_realtime_enrichment": true,
"advertisement_formats": [
"image",
"video"
],
"reach_tiers": [
"100k_500k",
"500k_1m",
"1m_plus"
],
"advertisement_active_ads": [
1,
null
],
"advertisement_running_ads": [
1,
null
],
"advertisement_total_ads": [
10,
null
],
"advertisement_platform_count": [
2,
null
],
"advertisement_format_count": [
2,
null
],
"advertisement_impressions_estimate": [
1000,
null
],
"advertisement_country_activity": {
"country": "US",
"rank": [
null,
500
]
},
"source_types": [
"linkedin",
"facebook"
],
"exclude_source_types": [
"apple"
],
"enrichment_mode": "latest",
"per_page": 25,
"page": 1,
"is_ascending_order": false,
"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"],
"active_dates": ["2026-08-01", "2026-08-31"],
"created_at": "2026-09-02T12:00:00Z",
"company_locations": ["US", "SG", "CN"],
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"advertisement_search_id": "a92643e8-9033-4029-aa65-ef929327cebb",
"domains": ["pubrio.com"],
"linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
"is_realtime_enrichment": True,
"advertisement_formats": ["image", "video"],
"reach_tiers": ["100k_500k", "500k_1m", "1m_plus"],
"advertisement_active_ads": [1, None],
"advertisement_running_ads": [1, None],
"advertisement_total_ads": [10, None],
"advertisement_platform_count": [2, None],
"advertisement_format_count": [2, None],
"advertisement_impressions_estimate": [1000, None],
"advertisement_country_activity": {
"country": "US",
"rank": [None, 500]
},
"source_types": ["linkedin", "facebook"],
"exclude_source_types": ["apple"],
"enrichment_mode": "latest",
"per_page": 25,
"page": 1,
"is_ascending_order": False,
"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'],
active_dates: ['2026-08-01', '2026-08-31'],
created_at: '2026-09-02T12:00:00Z',
company_locations: ['US', 'SG', 'CN'],
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
advertisement_search_id: 'a92643e8-9033-4029-aa65-ef929327cebb',
domains: ['pubrio.com'],
linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
is_realtime_enrichment: true,
advertisement_formats: ['image', 'video'],
reach_tiers: ['100k_500k', '500k_1m', '1m_plus'],
advertisement_active_ads: [1, null],
advertisement_running_ads: [1, null],
advertisement_total_ads: [10, null],
advertisement_platform_count: [2, null],
advertisement_format_count: [2, null],
advertisement_impressions_estimate: [1000, null],
advertisement_country_activity: {country: 'US', rank: [null, 500]},
source_types: ['linkedin', 'facebook'],
exclude_source_types: ['apple'],
enrichment_mode: 'latest',
per_page: 25,
page: 1,
is_ascending_order: false,
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'
],
'active_dates' => [
'2026-08-01',
'2026-08-31'
],
'created_at' => '2026-09-02T12:00:00Z',
'company_locations' => [
'US',
'SG',
'CN'
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'advertisement_search_id' => 'a92643e8-9033-4029-aa65-ef929327cebb',
'domains' => [
'pubrio.com'
],
'linkedin_urls' => [
'https://www.linkedin.com/company/pubrio'
],
'is_realtime_enrichment' => true,
'advertisement_formats' => [
'image',
'video'
],
'reach_tiers' => [
'100k_500k',
'500k_1m',
'1m_plus'
],
'advertisement_active_ads' => [
1,
null
],
'advertisement_running_ads' => [
1,
null
],
'advertisement_total_ads' => [
10,
null
],
'advertisement_platform_count' => [
2,
null
],
'advertisement_format_count' => [
2,
null
],
'advertisement_impressions_estimate' => [
1000,
null
],
'advertisement_country_activity' => [
'country' => 'US',
'rank' => [
null,
500
]
],
'source_types' => [
'linkedin',
'facebook'
],
'exclude_source_types' => [
'apple'
],
'enrichment_mode' => 'latest',
'per_page' => 25,
'page' => 1,
'is_ascending_order' => false,
'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 \"active_dates\": [\n \"2026-08-01\",\n \"2026-08-31\"\n ],\n \"created_at\": \"2026-09-02T12:00:00Z\",\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"advertisement_formats\": [\n \"image\",\n \"video\"\n ],\n \"reach_tiers\": [\n \"100k_500k\",\n \"500k_1m\",\n \"1m_plus\"\n ],\n \"advertisement_active_ads\": [\n 1,\n null\n ],\n \"advertisement_running_ads\": [\n 1,\n null\n ],\n \"advertisement_total_ads\": [\n 10,\n null\n ],\n \"advertisement_platform_count\": [\n 2,\n null\n ],\n \"advertisement_format_count\": [\n 2,\n null\n ],\n \"advertisement_impressions_estimate\": [\n 1000,\n null\n ],\n \"advertisement_country_activity\": {\n \"country\": \"US\",\n \"rank\": [\n null,\n 500\n ]\n },\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"exclude_source_types\": [\n \"apple\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"is_ascending_order\": false,\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 \"active_dates\": [\n \"2026-08-01\",\n \"2026-08-31\"\n ],\n \"created_at\": \"2026-09-02T12:00:00Z\",\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"advertisement_formats\": [\n \"image\",\n \"video\"\n ],\n \"reach_tiers\": [\n \"100k_500k\",\n \"500k_1m\",\n \"1m_plus\"\n ],\n \"advertisement_active_ads\": [\n 1,\n null\n ],\n \"advertisement_running_ads\": [\n 1,\n null\n ],\n \"advertisement_total_ads\": [\n 10,\n null\n ],\n \"advertisement_platform_count\": [\n 2,\n null\n ],\n \"advertisement_format_count\": [\n 2,\n null\n ],\n \"advertisement_impressions_estimate\": [\n 1000,\n null\n ],\n \"advertisement_country_activity\": {\n \"country\": \"US\",\n \"rank\": [\n null,\n 500\n ]\n },\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"exclude_source_types\": [\n \"apple\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"is_ascending_order\": false,\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 \"active_dates\": [\n \"2026-08-01\",\n \"2026-08-31\"\n ],\n \"created_at\": \"2026-09-02T12:00:00Z\",\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"advertisement_search_id\": \"a92643e8-9033-4029-aa65-ef929327cebb\",\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"is_realtime_enrichment\": true,\n \"advertisement_formats\": [\n \"image\",\n \"video\"\n ],\n \"reach_tiers\": [\n \"100k_500k\",\n \"500k_1m\",\n \"1m_plus\"\n ],\n \"advertisement_active_ads\": [\n 1,\n null\n ],\n \"advertisement_running_ads\": [\n 1,\n null\n ],\n \"advertisement_total_ads\": [\n 10,\n null\n ],\n \"advertisement_platform_count\": [\n 2,\n null\n ],\n \"advertisement_format_count\": [\n 2,\n null\n ],\n \"advertisement_impressions_estimate\": [\n 1000,\n null\n ],\n \"advertisement_country_activity\": {\n \"country\": \"US\",\n \"rank\": [\n null,\n 500\n ]\n },\n \"source_types\": [\n \"linkedin\",\n \"facebook\"\n ],\n \"exclude_source_types\": [\n \"apple\"\n ],\n \"enrichment_mode\": \"latest\",\n \"per_page\": 25,\n \"page\": 1,\n \"is_ascending_order\": false,\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{
"metadata": {
"profile": null,
"filters": {
"source_types": [
"linkedin"
],
"per_page": 25,
"language": "en"
},
"ignored_fields": [],
"applied_source_types": [
"linkedin"
]
},
"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,
"advertisement_format_normalized": "image",
"is_company_matched": true,
"advertiser": "Thuraya",
"advertiser_url": "https://www.linkedin.com/company/thuraya",
"advertisement_url": "https://www.linkedin.com/ad-library/detail/1518455034",
"total_impressions": "< 1k",
"total_impressions_lower": null,
"total_impressions_upper": 1000
},
{
"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"
},
"advertisement_format_normalized": "image",
"is_company_matched": true,
"advertiser": "Thuraya",
"advertiser_url": "https://www.linkedin.com/company/thuraya",
"advertisement_url": "https://www.linkedin.com/ad-library/detail/1518455034",
"total_impressions": "< 1k",
"total_impressions_lower": null,
"total_impressions_upper": 1000
},
"..."
]
}
}{
"code": 40001,
"message": "エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。",
"details": {}
}{
"error": "クライアントはしばらく待ってから再試行することが推奨されます。"
}{
"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"]
両端含みの [from, to]（UTC）。期間中のいずれかの時点で配信中だった広告を返し、以前に開始した広告も含むため広告インサイトと一致します。日付のない広告は created_at から数えます。両方の日付が必須で from ≤ to。
Required array length:
2 elements例:
["2026-08-01", "2026-08-31"]
この時刻以降に取り込まれたもの（UTC）。日付または ISO タイムスタンプ。増分同期では保存済み最新行の created_at を渡してください。
例:
"2026-09-02T12:00:00Z"
企業本社の所在地を示すフィルターです。
例:
["US", "SG", "CN"]
企業および人物検索処理で利用する domain_search_id の一覧です。
このレコード 1 件のみを返します。以前保存した行をページングせずに再取得するのに便利です。
例:
"a92643e8-9033-4029-aa65-ef929327cebb"
企業および人物検索に使用する会社ドメインの一覧です。www や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。
例:
["pubrio.com"]
企業の LinkedIn 公式ページを指す完全な URL です。値は http で始まり、linkedin.com/company/ を含んでいる必要があります。
例:
["https://www.linkedin.com/company/pubrio"]
単一企業スコープのクエリ（domain_search_id、domains、または linkedin_urls でフィルタリング）でリアルタイムエンリッチメントを有効化します。初回検索が 0 件の場合、エンドポイントはソースをスクレイプし、レコードを保存したうえで検索を再実行してから応答します。ルートごとのデッドラインの対象です。
例:
true
これらのクリエイティブフォーマットのいずれかで、広告を少なくとも 1 件出稿している企業を検索します。
利用可能なオプション:
image, video, text, carousel, dynamic_product, document, message, event, article, spotlight, follow, job, engagement 例:
["image", "video"]
広告のインプレッション帯域：lt_1k、1k_10k、10k_50k、50k_100k、100k_500k、500k_1m、1m_plus。total_impressions のない広告は一致せず、未知のスラッグは何にも一致しません。
利用可能なオプション:
lt_1k, 1k_10k, 10k_50k, 50k_100k, 100k_500k, 500k_1m, 1m_plus 例:
["100k_500k", "500k_1m", "1m_plus"]
企業が現在アクティブにしている広告件数の最小値と最大値です(すべての国の合計)。上限または下限を設けない場合は null を指定します。例:「アクティブな広告が 1 件以上」を表すには [1, null] とします。
Required array length:
2 elements例:
[1, null]
企業の広告のうち、配信が終了していないもの(終了日が未設定、または終了日が未来の日付)の件数の最小値と最大値です。現時点では LinkedIn 広告にのみデータが存在します。
Required array length:
2 elements例:
[1, null]
これまでに記録された、企業の広告の総件数の最小値と最大値です(すべての国の合計)。
Required array length:
2 elements例:
[10, null]
企業が現在広告を出稿している、異なる広告プラットフォーム(linkedin、facebook、google、tiktok、apple)の数の最小値と最大値です。
Required array length:
2 elements例:
[2, null]
企業が現在配信している、異なる広告クリエイティブフォーマットの数の最小値と最大値です。
Required array length:
2 elements例:
[2, null]
推定広告インプレッション数の最小値と最大値です(すべての国の合計)。インプレッション範囲が報告されている広告のみが集計対象です。
Required array length:
2 elements例:
[1000, null]
特定の 1 か国における広告アクティビティです。country は必須で、それ以外のフィールドを少なくとも 1 つ指定する必要があります(country のみでは何にもマッチしません)。すべての国を合計した値を求める場合は、代わりにトップレベルの advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate フィルターを使用してください。
Show child attributes
Show child attributes
例:
{ "country": "US", "rank": [null, 500] }
含めるソース：linkedin、facebook（meta も可）、google、tiktok、apple。未知の値は何にも一致せず metadata.unsupported_source_types にエコーされます。
利用可能なオプション:
linkedin, facebook, google, tiktok, apple 例:
["linkedin", "facebook"]
これらのソースから取得した広告を除外します。語彙は source_types と同じです（linkedin、facebook、google、tiktok、apple。meta は facebook のエイリアス）。未知の値は無視されます。
利用可能なオプション:
linkedin, facebook, google, tiktok, apple 例:
["apple"]
リアルタイムエンリッチメントの動作を制御します。default はデータベースにすでに存在するデータを返し、結果が空で is_realtime_enrichment が設定されている場合にのみエンリッチメントを実行します。latest はキャッシュをバイパスし、呼び出しごとに最新のソースレコードに対する再エンリッチメントを強制します。他のフラグが設定されていなくても、latest 自体が単独でエンリッチメントを起動します。
利用可能なオプション:
default, latest 例:
"latest"
並び順です。デフォルトは新しい順で返され、true にすると古い順になります。このエンドポイントに sort_by はなく、ソートキーは固定でエンドポイントの説明に記載しています。
例:
false
配信された配置面で Facebook/Meta 広告をフィルタリングします。小文字で、大文字・小文字を区別しません。facebook ソースにのみ適用されます（他のソースは単一プラットフォーム）。
利用可能なオプション:
facebook, instagram, messenger, threads, audience_network 例:
["facebook", "instagram"]
これらの配置面で配信された Facebook/Meta 広告を除外します。
利用可能なオプション:
facebook, instagram, messenger, threads, audience_network 例:
["audience_network"]
解決済みの企業に紐づいていない広告（未加工レイヤーの広告。詐欺・使い捨てページ広告など）を含めます。デフォルトは false で、企業に紐づく広告のみを返します。
例:
true
最終更新日 2026年3月3日