Búsqueda de anuncios de la empresa

Buscar anuncios 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": "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

Buscar anuncios 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": "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."
}

Autorizaciones

pubrio-api-key

string

header

requerido

Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección Configuración.

Cuerpo

application/json

target_locations

string[]

Filtra anuncios para incluir aquellos dirigidos a ubicaciones específicas por código de país. Úsalo para encontrar anuncios que se están mostrando en países concretos. Se combina con filter_conditions usando el operador OR: el anuncio debe estar dirigido al menos a una de las ubicaciones especificadas.

Ejemplo:

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

exclude_target_locations

string[]

Filtra anuncios para excluir aquellos dirigidos a ubicaciones específicas por código de país. Úsalo para descartar anuncios que se están mostrando en países concretos. Cuando se especifica en filter_conditions con el operador 'or', el anuncio no debe estar dirigido a ninguna de las ubicaciones excluidas.

Ejemplo:

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

search_terms

string[]

Una lista de cadenas sobre las que queremos filtrar los resultados.

Ejemplo:

["pubrio"]

headlines

string[]

Una lista de titulares para filtrar los resultados de búsqueda.

Ejemplo:

["ASUS", "iPhone"]

filter_conditions

object[]

Opciones de filtrado avanzado para búsquedas de anuncios. Especifica condiciones para refinar los resultados de búsqueda del endpoint de búsqueda de anuncios.

Show child attributes

start_dates

string<date>[]

Una lista de fechas de inicio para filtrar los resultados de búsqueda.

Ejemplo:

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

end_dates

string<date>[]

Una lista de fechas de fin para filtrar los resultados de búsqueda.

Ejemplo:

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

active_dates

string<date>[]

Ventana inclusiva [from, to] (UTC). Devuelve los anuncios que estuvieron activos en algún momento de ese intervalo, incluidos los que comenzaron antes, de modo que coincide con Advertisement Insights. Los anuncios sin fecha se cuentan a partir de created_at. Se requieren ambas fechas, from ≤ to.

Required array length: 2 elements

Ejemplo:

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

created_at

string<date-time>

Ingerido en este instante o después (UTC). Fecha o marca de tiempo ISO. Para sincronizaciones incrementales, pasa el created_at de tu registro almacenado más reciente.

Ejemplo:

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

company_locations

string[]

La ubicación de la sede de la empresa. Consulta los endpoints location en la pestaña Filters para más información.

Ejemplo:

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

companies

string<uuid>[]

Una lista de identificadores únicos (domain_search_id) utilizada para operaciones de búsqueda de empresas y personas.

advertisement_search_id

string<uuid>

Devuelve únicamente este registro. Útil para volver a obtener una fila que guardaste antes sin paginar.

Ejemplo:

"a92643e8-9033-4029-aa65-ef929327cebb"

domains

string[]

Lista de dominios de empresa utilizada para operaciones de búsqueda de empresas y personas. Si recibimos una URL como www.pubrio.com o https://docs.pubrio.com/, el sistema la convertirá a pubrio.com para su procesamiento.

Ejemplo:

["pubrio.com"]

linkedin_urls

string[]

La URL completa del perfil de LinkedIn de la empresa. La URL debe empezar por http y contener linkedin.com/company/

Ejemplo:

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

is_realtime_enrichment

boolean

predeterminado:false

Activa el enriquecimiento en tiempo real para una única consulta con alcance de empresa (filtrada por domain_search_id, domains o linkedin_urls). Cuando la búsqueda inicial devuelve cero resultados, el endpoint extrae la fuente, persiste los registros y vuelve a ejecutar la búsqueda antes de responder. Sujeto a un límite de tiempo por ruta.

Ejemplo:

true

advertisement_formats

enum<string>[]

Encuentra empresas con al menos un anuncio en cualquiera de estos formatos creativos.

Opciones disponibles:

image,

video,

text,

carousel,

dynamic_product,

document,

message,

event,

article,

spotlight,

follow,

job,

engagement

Ejemplo:

["image", "video"]

reach_tiers

enum<string>[]

Rango de impresiones del anuncio: lt_1k, 1k_10k, 10k_50k, 50k_100k, 100k_500k, 500k_1m, 1m_plus. Los anuncios sin valor de total_impressions nunca coinciden; los slugs desconocidos no coinciden con nada.

Opciones disponibles:

lt_1k,

1k_10k,

10k_50k,

50k_100k,

100k_500k,

500k_1m,

1m_plus

Ejemplo:

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

advertisement_active_ads

(integer | null)[]

Recuento mínimo y máximo de anuncios actualmente activos de la empresa, en todos los países. Usa null para un límite abierto, por ejemplo [1, null] para "al menos un anuncio activo".

Required array length: 2 elements

Ejemplo:

[1, null]

advertisement_running_ads

(integer | null)[]

Recuento mínimo y máximo de anuncios de la empresa que siguen activos (sin fecha de fin, o con fecha de fin futura). Actualmente solo se completa para anuncios de LinkedIn.

Required array length: 2 elements

Ejemplo:

[1, null]

advertisement_total_ads

(integer | null)[]

Recuento mínimo y máximo del total de anuncios registrados de la empresa, en todos los países.

Required array length: 2 elements

Ejemplo:

[10, null]

advertisement_platform_count

(integer | null)[]

Número mínimo y máximo de plataformas publicitarias distintas (linkedin, facebook, google, tiktok, apple) en las que la empresa está anunciando activamente.

Required array length: 2 elements

Ejemplo:

[2, null]

advertisement_format_count

(integer | null)[]

Número mínimo y máximo de formatos creativos de anuncio distintos que la empresa está utilizando activamente.

Required array length: 2 elements

Ejemplo:

[2, null]

advertisement_impressions_estimate

(integer | null)[]

Impresiones estimadas de anuncios, mínimas y máximas, sumadas en todos los países. Solo se cuentan los anuncios con un rango de impresiones reportado.

Required array length: 2 elements

Ejemplo:

[1000, null]

advertisement_country_activity

object

Actividad publicitaria para un país específico. country es obligatorio, y debe establecerse al menos otro campo (un país por sí solo no coincide con nada). Para un total de todos los países, usa en su lugar los filtros de nivel superior advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate.

Show child attributes

Ejemplo:

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

source_types

enum<string>[]

Fuentes a incluir: linkedin, facebook (se acepta meta), google, tiktok, apple. Los valores desconocidos no coinciden con nada y se reflejan en metadata.unsupported_source_types.

Opciones disponibles:

linkedin,

facebook,

google,

tiktok,

apple

Ejemplo:

["linkedin", "facebook"]

exclude_source_types

enum<string>[]

Excluye anuncios capturados de estas fuentes. Mismo vocabulario que source_types (linkedin, facebook, google, tiktok, apple; meta es un alias de facebook). Los valores desconocidos se ignoran.

Opciones disponibles:

linkedin,

facebook,

google,

tiktok,

apple

Ejemplo:

["apple"]

enrichment_mode

enum<string>

predeterminado:default

Controla el comportamiento del enriquecimiento en tiempo real. default devuelve lo que ya existe en la base de datos, y solo activa el enriquecimiento cuando el conjunto de resultados está vacío y is_realtime_enrichment está establecido. latest omite la caché y fuerza una nueva pasada de enriquecimiento contra los registros de origen más recientes en cada llamada — activa el enriquecimiento por sí solo, sin necesitar ningún otro indicador.

Opciones disponibles:

default,

latest

Ejemplo:

"latest"

per_page

integer

predeterminado:25

Registros por página. Por defecto es 25, que también es el límite en la mayoría de los planes — el límite es el max_search_per_page de tu suscripción, devuelto por Perfil. Superarlo devuelve HTTP 416 con el código 41676 (o 41613 en la búsqueda de empresas y personas), no un conjunto de resultados recortado.

Rango requerido: x <= 25

Ejemplo:

25

page

integer

predeterminado:1

Número de página, empezando en 1. El límite es el max_search_page de tu suscripción (max_company_search_page para la búsqueda de empresas), devuelto por Perfil. Superarlo devuelve HTTP 416.

Ejemplo:

1

is_ascending_order

boolean

predeterminado:false

Dirección de ordenación. Los resultados se devuelven por defecto de más reciente a más antiguo; establece true para el orden inverso (de más antiguo a más reciente). No existe sort_by en este endpoint: la clave de ordenación es fija y se indica en la descripción del endpoint.

Ejemplo:

false

publisher_platforms

enum<string>[]

Filtra anuncios de Facebook/Meta según la superficie de plataforma en la que se entregaron. En minúsculas y sin distinción entre mayúsculas y minúsculas. Solo se aplica a la fuente facebook (las demás fuentes son de plataforma única).

Opciones disponibles:

facebook,

instagram,

messenger,

threads,

audience_network

Ejemplo:

["facebook", "instagram"]

exclude_publisher_platforms

enum<string>[]

Excluye anuncios de Facebook/Meta entregados en estas superficies de plataforma.

Opciones disponibles:

facebook,

instagram,

messenger,

threads,

audience_network

Ejemplo:

["audience_network"]

is_include_unlinked_companies

boolean

predeterminado:false

Incluye anuncios aún no vinculados a una empresa resuelta (anuncios de capa bruta, por ejemplo, anuncios fraudulentos o de páginas desechables). Por defecto es false, lo que devuelve únicamente anuncios atribuidos a una empresa.

Ejemplo:

true

Respuesta

Respuesta exitosa que contiene los detalles de la búsqueda de anuncios de empresas.

metadata

object

Contexto de la solicitud.

Show child attributes

data

object

Show child attributes

Última modificación el 4 de septiembre de 2026

Documentación de la API

Endpoints

Búsqueda de anuncios de la empresa

Autorizaciones

Cuerpo

Respuesta