Поиск рекламы компаний

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": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}

{
  "error": "Request rate limit exceeded. Please wait and try again later."
}

{
  "error": "An unexpected error occurred on the server."
}

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": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}

{
  "error": "Request rate limit exceeded. Please wait and try again later."
}

{
  "error": "An unexpected error occurred on the server."
}

Авторизации

pubrio-api-key

string

header

обязательно

Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе Settings.

Тело

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). Возвращает рекламу, показывавшуюся в любой момент в этом диапазоне, включая начавшуюся ранее, поэтому согласуется с Advertisement Insights. Реклама без даты учитывается по 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 на вкладке Filters.

Пример:

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

companies

string<uuid>[]

Список уникальных идентификаторов (domain_search_id), используемых для операций поиска компаний и людей.

advertisement_search_id

string<uuid>

Вернуть только эту одну запись. Удобно для повторного получения ранее сохранённой строки без постраничной навигации.

Пример:

"a92643e8-9033-4029-aa65-ef929327cebb"

domains

string[]

Список доменов компаний, используемых для операций поиска компаний и людей. Если получен URL вида www.pubrio.com или https://docs.pubrio.com/, система преобразует его в pubrio.com для обработки.

Пример:

["pubrio.com"]

linkedin_urls

string[]

Полностью сформированный URL профиля компании в LinkedIn. URL начинается с http и содержит linkedin.com/company/

Пример:

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

is_realtime_enrichment

boolean

по умолчанию:false

Включить обогащение в реальном времени для одного запроса в рамках конкретной компании (отфильтрованного по domain_search_id, domains или linkedin_urls). Если первоначальный поиск не возвращает результатов, эндпоинт извлекает данные из источника, сохраняет записи и повторно выполняет поиск перед формированием ответа. Действует ограничение по времени для каждого маршрута.

Пример:

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 обходит кэш и принудительно запускает повторное обогащение по самым свежим исходным записям при каждом вызове — он запускает обогащение самостоятельно, без необходимости в других флагах.

Доступные опции:

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

Последнее изменение 4 сентября 2026 г.

Документация API

Конечные точки

Поиск рекламы компаний

Авторизации

Тело

Ответ