기업 광고 검색 - Pubrio Documentation

기업 광고 검색

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": "요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다"
}

POST

companies

advertisements

기업 광고 검색

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": "요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다"
}

인증

pubrio-api-key

string

header

필수

API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 설정 섹션에서 생성할 수 있습니다.

본문

application/json

target_locations

string[]

결과가 대상으로 해야 하는 국가 코드. 기본적으로 filter_conditions와 OR로 결합되어 하나라도 해당하면 일치합니다.

예시:

["TW", "AE", "NO"]

exclude_target_locations

string[]

결과가 대상으로 하지 않아야 하는 국가 코드. 기본적으로 filter_conditions와 OR로 결합되어 하나라도 해당하면 일치합니다.

예시:

["IS", "GB", "FR", "IE", "ES"]

search_terms

string[]

검색 결과를 필터링하는 키워드 문자열 목록입니다.

예시:

["pubrio"]

headlines

string[]

검색 결과를 필터링하는 제목 목록입니다.

예시:

["ASUS", "iPhone"]

filter_conditions

object[]

광고 검색의 고급 필터링 옵션입니다. 광고 검색 엔드포인트의 검색 결과를 개선하기 위한 조건을 지정합니다.

Show child attributes

start_dates

string<date>[]

검색 결과를 필터링하는 시작 날짜 목록입니다.

예시:

["2025-12-01", "2025-12-01"]

end_dates

string<date>[]

검색 결과를 필터링하는 종료 날짜 목록입니다.

예시:

["2025-12-25", "2025-12-25"]

active_dates

string<date>[]

양끝 포함 [from, to](UTC). 범위 안의 어느 시점에라도 집행 중이던 광고를 반환하며, 더 일찍 시작한 광고도 포함되어 광고 인사이트와 일치합니다. 날짜 없는 광고는 created_at부터 계산합니다. 두 날짜 모두 필수, from ≤ to.

Required array length: 2 elements

예시:

["2026-08-01", "2026-08-31"]

created_at

string<date-time>

이 시각 이후에 수집됨(UTC). 날짜 또는 ISO 타임스탬프. 증분 동기화에서는 저장한 최신 행의 created_at을 전달하세요.

예시:

"2026-09-02T12:00:00Z"

company_locations

string[]

회사 본사 위치입니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참고하세요.

예시:

["US", "SG", "CN"]

companies

string<uuid>[]

회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록.

advertisement_search_id

string<uuid>

이 레코드 하나만 반환합니다. 이전에 저장한 행을 페이징 없이 다시 가져올 때 편리합니다.

예시:

"a92643e8-9033-4029-aa65-ef929327cebb"

domains

string[]

회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 www.pubrio.com 또는 https://docs.pubrio.com/인 경우, 시스템은 이를 자동으로 pubrio.com으로 변환하여 처리합니다.

예시:

["pubrio.com"]

linkedin_urls

string[]

LinkedIn 회사 페이지의 전체 URL입니다. http로 시작하며 linkedin.com/company/를 포함해야 합니다.

예시:

["https://www.linkedin.com/company/pubrio"]

is_realtime_enrichment

boolean

기본값:false

단일 회사 범위 쿼리(즉, domain_search_id, domains, 또는 linkedin_urls 로 필터링됨)에서 실시간 보강을 활성화합니다. 초기 검색 결과가 0건일 때 엔드포인트가 소스를 스크랩해 레코드를 저장한 뒤 검색을 다시 실행하고 응답합니다. 라우트별 데드라인이 적용됩니다.

예시:

true

advertisement_formats

enum<string>[]

이 크리에이티브 형식 중 하나 이상으로 광고를 집행한 회사를 찾습니다.

사용 가능한 옵션:

image,

video,

text,

carousel,

dynamic_product,

document,

message,

event,

article,

spotlight,

follow,

job,

engagement

예시:

["image", "video"]

reach_tiers

enum<string>[]

광고의 노출 구간: 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"]

advertisement_active_ads

(integer | null)[]

모든 국가를 통틀어 회사의 현재 활성 광고 수의 최소 및 최대값입니다. 상한 또는 하한을 열어두려면 null을 사용하세요. 예를 들어 [1, null]은 "활성 광고가 하나 이상"을 의미합니다.

Required array length: 2 elements

예시:

[1, null]

advertisement_running_ads

(integer | null)[]

종료일이 없거나 종료일이 미래인, 즉 아직 게재 중인 회사 광고 수의 최소 및 최대값입니다. 현재는 LinkedIn 광고에 대해서만 값이 채워집니다.

Required array length: 2 elements

예시:

[1, null]

advertisement_total_ads

(integer | null)[]

모든 국가를 통틀어 지금까지 기록된 회사의 전체 광고 수의 최소 및 최대값입니다.

Required array length: 2 elements

예시:

[10, null]

advertisement_platform_count

(integer | null)[]

회사가 현재 광고를 집행 중인 서로 다른 광고 플랫폼(linkedin, facebook, google, tiktok, apple) 수의 최소 및 최대값입니다.

Required array length: 2 elements

예시:

[2, null]

advertisement_format_count

(integer | null)[]

회사가 현재 게재 중인 서로 다른 광고 크리에이티브 형식 수의 최소 및 최대값입니다.

Required array length: 2 elements

예시:

[2, null]

advertisement_impressions_estimate

(integer | null)[]

모든 국가를 합산한 예상 광고 노출수의 최소 및 최대값입니다. 노출 범위가 보고된 광고만 집계됩니다.

Required array length: 2 elements

예시:

[1000, null]

advertisement_country_activity

object

특정 국가 하나에 대한 광고 활동입니다. country는 필수이며, 그 외 필드 중 최소 하나는 설정해야 합니다(국가만 지정하면 아무것도 매치되지 않습니다). 전체 국가 합계가 필요하다면 최상위의 advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate 필터를 대신 사용하세요.

Show child attributes

예시:

{ "country": "US", "rank": [null, 500] }

source_types

enum<string>[]

포함할 소스: linkedin, facebook(meta 허용), google, tiktok, apple. 알 수 없는 값은 아무것도 일치하지 않고 metadata.unsupported_source_types에 반환됩니다.

사용 가능한 옵션:

linkedin,

facebook,

google,

tiktok,

apple

예시:

["linkedin", "facebook"]

exclude_source_types

enum<string>[]

이 소스에서 수집한 광고를 제외합니다. 어휘는 source_types와 동일합니다(linkedin, facebook, google, tiktok, apple; meta는 facebook의 별칭). 알 수 없는 값은 무시됩니다.

사용 가능한 옵션:

linkedin,

facebook,

google,

tiktok,

apple

예시:

["apple"]

enrichment_mode

enum<string>

기본값:default

실시간 보강 동작을 제어합니다. default 는 데이터베이스에 이미 있는 데이터를 반환하며, 결과가 비어 있고 is_realtime_enrichment 가 설정된 경우에만 보강을 트리거합니다. latest 는 캐시를 우회하고 호출마다 최신 소스 레코드를 기준으로 재보강을 강제합니다 — 다른 플래그 없이도 latest 자체가 보강을 트리거합니다.

사용 가능한 옵션:

default,

latest

예시:

"latest"

per_page

integer

기본값:25

페이지당 레코드 수입니다. 기본값은 25이며 대부분의 플랜에서 상한이기도 합니다. 이 한도는 구독의 max_search_per_page이며 Profile에서 확인할 수 있습니다. 초과하면 결과가 잘리는 것이 아니라 HTTP 416과 코드 41676(기업·인물 검색은 41613)이 반환됩니다.

필수 범위: x <= 25

예시:

25

page

integer

기본값:1

페이지 번호이며 1부터 시작합니다. 상한은 구독의 max_search_page(기업 검색은 max_company_search_page)이며 Profile에서 확인할 수 있습니다. 초과하면 HTTP 416이 반환됩니다.

예시:

1

is_ascending_order

boolean

기본값:false

정렬 방향입니다. 기본값은 최신순이며 true로 설정하면 오래된 순으로 반환합니다. 이 엔드포인트에는 sort_by가 없으며, 정렬 키는 고정되어 엔드포인트 설명에 명시되어 있습니다.

예시:

false

publisher_platforms

enum<string>[]

게재된 플랫폼 노출 위치로 Facebook/Meta 광고를 필터링합니다. 소문자이며 대소문자를 구분하지 않습니다. facebook 소스에만 적용됩니다(다른 소스는 단일 플랫폼).

사용 가능한 옵션:

facebook,

instagram,

messenger,

threads,

audience_network

예시:

["facebook", "instagram"]

exclude_publisher_platforms

enum<string>[]

이 플랫폼 노출 위치에서 게재된 Facebook/Meta 광고를 제외합니다.

사용 가능한 옵션:

facebook,

instagram,

messenger,

threads,

audience_network

예시:

["audience_network"]

is_include_unlinked_companies

boolean

기본값:false

확인된 회사에 아직 연결되지 않은 광고(원시 계층 광고, 예: 사기 또는 일회용 페이지 광고)를 포함합니다. 기본값은 false이며 회사에 연결된 광고만 반환합니다.

예시:

true

응답

회사 광고 검색 세부 정보가 포함된 성공적인 응답입니다.

metadata

object

요청 컨텍스트입니다.

Show child attributes

data

object

Show child attributes

마지막 수정일 2026년 3월 3일