Busca de Anúncios de Empresas

Buscar anúncios de empresas

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": "Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações.",
  "details": {}
}

{
  "error": "Limite de requisições excedido. Aguarde e tente novamente mais tarde."
}

{
  "error": "Ocorreu um erro inesperado no servidor."
}

POST

companies

advertisements

Buscar anúncios de empresas

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": "Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações.",
  "details": {}
}

{
  "error": "Limite de requisições excedido. Aguarde e tente novamente mais tarde."
}

{
  "error": "Ocorreu um erro inesperado no servidor."
}

Autorizações

pubrio-api-key

string

header

obrigatório

Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção Configurações.

Corpo

application/json

target_locations

string[]

Filtra anúncios para incluir aqueles direcionados a localizações específicas por código de país. Use isso para encontrar anúncios que estão sendo exibidos em países específicos. Combina-se com filter_conditions usando o operador OR - o anúncio deve ter como alvo pelo menos uma das localizações especificadas.

Exemplo:

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

exclude_target_locations

string[]

Filtra anúncios para excluir aqueles direcionados a localizações específicas por código de país. Use isso para excluir anúncios que estão sendo exibidos em países específicos. Quando especificado em filter_conditions com o operador 'or', o anúncio não deve ter como alvo nenhuma das localizações excluídas.

Exemplo:

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

search_terms

string[]

Uma lista de strings pelas quais queremos filtrar os resultados.

Exemplo:

["pubrio"]

headlines

string[]

Uma lista de títulos para filtrar os resultados da busca.

Exemplo:

["ASUS", "iPhone"]

filter_conditions

object[]

Opções avançadas de filtragem para buscas de anúncios. Especifique condições para refinar os resultados da busca no endpoint de busca de anúncios.

Show child attributes

start_dates

string<date>[]

Uma lista de datas de início para filtrar os resultados da busca.

Exemplo:

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

end_dates

string<date>[]

Uma lista de datas de término para filtrar os resultados da busca.

Exemplo:

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

active_dates

string<date>[]

Janela inclusiva [from, to] (UTC). Retorna anúncios em veiculação em qualquer ponto dela, incluindo os que começaram antes, o que a torna compatível com o Advertisement Insights. Anúncios sem data são contados a partir de created_at. Ambas as datas são obrigatórias, from ≤ to.

Required array length: 2 elements

Exemplo:

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

created_at

string<date-time>

Ingerido neste instante ou depois (UTC). Data ou timestamp ISO. Para sincronizações incrementais, informe o created_at do seu registro armazenado mais recente.

Exemplo:

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

company_locations

string[]

A localização da sede da empresa. Consulte os endpoints de location na aba Filters para mais informações.

Exemplo:

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

companies

string<uuid>[]

Uma lista de identificadores únicos (domain_search_id) usada para operações de busca de empresas e pessoas.

advertisement_search_id

string<uuid>

Retorna apenas este registro. Útil para buscar novamente um registro que você armazenou anteriormente, sem precisar paginar.

Exemplo:

"a92643e8-9033-4029-aa65-ef929327cebb"

domains

string[]

Lista de domínios de empresas usada para operações de busca de empresas e pessoas. Se recebermos uma URL como www.pubrio.com ou https://docs.pubrio.com/, o sistema a converterá para pubrio.com para processamento.

Exemplo:

["pubrio.com"]

linkedin_urls

string[]

A URL completa do perfil da empresa no LinkedIn. A URL começa com http e contém linkedin.com/company/

Exemplo:

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

is_realtime_enrichment

boolean

padrão:false

Ativa o enriquecimento em tempo real para uma única consulta com escopo de empresa (filtrada por domain_search_id, domains ou linkedin_urls). Quando a busca inicial retorna zero resultados, o endpoint extrai a fonte, persiste os registros e executa a busca novamente antes de responder. Sujeito a um prazo limite por rota.

Exemplo:

true

advertisement_formats

enum<string>[]

Encontra empresas com pelo menos um anúncio em qualquer um destes formatos criativos.

Opções disponíveis:

image,

video,

text,

carousel,

dynamic_product,

document,

message,

event,

article,

spotlight,

follow,

job,

engagement

Exemplo:

["image", "video"]

reach_tiers

enum<string>[]

Faixa de impressões do anúncio: lt_1k, 1k_10k, 10k_50k, 50k_100k, 100k_500k, 500k_1m, 1m_plus. Anúncios sem um valor de total_impressions nunca correspondem; slugs desconhecidos não correspondem a nada.

Opções disponíveis:

lt_1k,

1k_10k,

10k_50k,

50k_100k,

100k_500k,

500k_1m,

1m_plus

Exemplo:

["100k_500k", "500k_1m", "1m_plus"]

advertisement_active_ads

(integer | null)[]

Contagem mínima e máxima de anúncios atualmente ativos da empresa, em todos os países. Use null para um limite aberto, por exemplo [1, null] para "pelo menos um anúncio ativo".

Required array length: 2 elements

Exemplo:

[1, null]

advertisement_running_ads

(integer | null)[]

Contagem mínima e máxima de anúncios da empresa que ainda estão em veiculação (sem data de término, ou com data de término no futuro). Atualmente preenchido apenas para anúncios do LinkedIn.

Required array length: 2 elements

Exemplo:

[1, null]

advertisement_total_ads

(integer | null)[]

Contagem mínima e máxima do total de anúncios já registrados pela empresa, em todos os países.

Required array length: 2 elements

Exemplo:

[10, null]

advertisement_platform_count

(integer | null)[]

Número mínimo e máximo de plataformas de anúncios distintas (linkedin, facebook, google, tiktok, apple) nas quais a empresa está ativamente anunciando.

Required array length: 2 elements

Exemplo:

[2, null]

advertisement_format_count

(integer | null)[]

Número mínimo e máximo de formatos criativos de anúncio distintos que a empresa está veiculando ativamente.

Required array length: 2 elements

Exemplo:

[2, null]

advertisement_impressions_estimate

(integer | null)[]

Estimativa mínima e máxima de impressões de anúncios, somadas em todos os países. Apenas anúncios com um intervalo de impressões reportado são contabilizados.

Required array length: 2 elements

Exemplo:

[1000, null]

advertisement_country_activity

object

Atividade de anúncios para um país específico. country é obrigatório, e pelo menos um outro campo deve ser definido (um país sozinho não corresponde a nada). Para um total considerando todos os países, use os filtros de nível superior advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate.

Show child attributes

Exemplo:

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

source_types

enum<string>[]

Fontes a incluir: linkedin, facebook (meta também é aceito), google, tiktok, apple. Valores desconhecidos não correspondem a nada e são reproduzidos em metadata.unsupported_source_types.

Opções disponíveis:

linkedin,

facebook,

google,

tiktok,

apple

Exemplo:

["linkedin", "facebook"]

exclude_source_types

enum<string>[]

Exclui anúncios capturados destas fontes. Mesmo vocabulário de source_types (linkedin, facebook, google, tiktok, apple; meta é um alias de facebook). Valores desconhecidos são ignorados.

Opções disponíveis:

linkedin,

facebook,

google,

tiktok,

apple

Exemplo:

["apple"]

enrichment_mode

enum<string>

padrão:default

Controla o comportamento de enriquecimento em tempo real. default retorna o que já está no banco de dados e só aciona o enriquecimento quando o conjunto de resultados está vazio e is_realtime_enrichment está definido. latest ignora o cache e força uma nova passagem de enriquecimento em relação aos registros de origem mais recentes a cada chamada — ele aciona o enriquecimento por conta própria, sem precisar de nenhuma outra flag.

Opções disponíveis:

default,

latest

Exemplo:

"latest"

per_page

integer

padrão:25

Registros por página. O padrão é 25, que também é o teto na maioria dos planos — o limite é o max_search_per_page da sua assinatura, retornado por Profile. Excedê-lo retorna HTTP 416 com o código 41676 (ou 41613 na busca de empresas e pessoas), não um conjunto de resultados limitado.

Intervalo necessário: x <= 25

Exemplo:

25

page

integer

padrão:1

Número da página, começando em 1. O teto é o max_search_page da sua assinatura (max_company_search_page para busca de empresas), retornado por Profile. Excedê-lo retorna HTTP 416.

Exemplo:

1

is_ascending_order

boolean

padrão:false

Direção da ordenação. Por padrão, os resultados são retornados do mais recente para o mais antigo; defina true para do mais antigo para o mais recente. Não há sort_by neste endpoint — a chave de ordenação é fixa e está indicada na descrição do endpoint.

Exemplo:

false

publisher_platforms

enum<string>[]

Filtra anúncios do Facebook/Meta pela superfície de plataforma em que foram veiculados. Minúsculas e sem diferenciação entre maiúsculas e minúsculas. Aplica-se apenas à fonte facebook (as demais fontes têm plataforma única).

Opções disponíveis:

facebook,

instagram,

messenger,

threads,

audience_network

Exemplo:

["facebook", "instagram"]

exclude_publisher_platforms

enum<string>[]

Exclui anúncios do Facebook/Meta veiculados nessas superfícies de plataforma.

Opções disponíveis:

facebook,

instagram,

messenger,

threads,

audience_network

Exemplo:

["audience_network"]

is_include_unlinked_companies

boolean

padrão:false

Inclui anúncios ainda não vinculados a uma empresa resolvida (anúncios da camada bruta, por exemplo, anúncios fraudulentos ou de páginas descartáveis). O padrão é false, que retorna apenas anúncios atribuídos a empresas.

Exemplo:

true

Resposta

Resposta bem-sucedida contendo os detalhes da busca de anúncios de empresas.

metadata

object

Contexto da requisição.

Show child attributes

data

object

Show child attributes

Última modificação em 4 de setembro de 2026

Documentação da API

Endpoints

Autorizações

Corpo

Resposta