Recherche d'annonces publicitaires d'entreprise

Rechercher des publicités d'entreprises

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

Rechercher des publicités d'entreprises

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."
}

Autorisations

pubrio-api-key

string

header

requis

Un jeton API unique qui représente les actions que vous effectuez via l'API ainsi que les autorisations et opérations correspondantes. Vous pouvez le créer dans la section Settings.

Corps

application/json

target_locations

string[]

Filtre les publicités pour inclure celles ciblant des localisations spécifiques par code pays. Utilisez ce paramètre pour trouver les publicités diffusées dans des pays spécifiques. Se combine avec filter_conditions à l'aide de l'opérateur OR - la publicité doit cibler au moins l'une des localisations spécifiées.

Exemple:

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

exclude_target_locations

string[]

Filtre les publicités pour exclure celles ciblant des localisations spécifiques par code pays. Utilisez ce paramètre pour écarter les publicités diffusées dans des pays spécifiques. Lorsqu'il est spécifié dans filter_conditions avec l'opérateur 'or', la publicité ne doit cibler aucune des localisations exclues.

Exemple:

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

search_terms

string[]

Une liste de chaînes sur lesquelles filtrer les résultats.

Exemple:

["pubrio"]

headlines

string[]

Une liste d'accroches pour filtrer les résultats de recherche.

Exemple:

["ASUS", "iPhone"]

filter_conditions

object[]

Options de filtrage avancées pour les recherches de publicités. Spécifiez des conditions pour affiner vos résultats de recherche pour le point de terminaison de recherche de publicités.

Show child attributes

start_dates

string<date>[]

Une liste de dates de début pour filtrer les résultats de recherche.

Exemple:

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

end_dates

string<date>[]

Une liste de dates de fin pour filtrer les résultats de recherche.

Exemple:

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

active_dates

string<date>[]

Fenêtre inclusive [from, to] (UTC). Renvoie les publicités actives à un moment quelconque de cette fenêtre, y compris celles qui ont démarré plus tôt, ce qui la fait correspondre à Advertisement Insights. Les publicités non datées comptent à partir de created_at. Les deux dates sont requises, from ≤ to.

Required array length: 2 elements

Exemple:

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

created_at

string<date-time>

Ingéré à cet instant ou après (UTC). Date ou horodatage ISO. Pour des synchronisations incrémentielles, transmettez le created_at de votre enregistrement stocké le plus récent.

Exemple:

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

company_locations

string[]

L'emplacement du siège social de l'entreprise. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:

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

companies

string<uuid>[]

Une liste d'identifiants uniques (domain_search_id) utilisée pour les opérations de recherche d'entreprises et de personnes.

advertisement_search_id

string<uuid>

Ne renvoie que cet enregistrement unique. Pratique pour récupérer à nouveau une ligne que vous avez stockée précédemment, sans pagination.

Exemple:

"a92643e8-9033-4029-aa65-ef929327cebb"

domains

string[]

Liste de domaines d'entreprise utilisée pour les opérations de recherche d'entreprises et de personnes. Si nous recevons une URL telle que www.pubrio.com ou https://docs.pubrio.com/, le système la convertira en pubrio.com pour le traitement.

Exemple:

["pubrio.com"]

linkedin_urls

string[]

L'URL complète du profil d'entreprise LinkedIn. L'URL commence par http et contient linkedin.com/company/

Exemple:

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

is_realtime_enrichment

boolean

défaut:false

Active l'enrichissement en temps réel pour une requête unique limitée à une entreprise (filtrée par domain_search_id, domains, ou linkedin_urls). Lorsque la recherche initiale ne renvoie aucun résultat, le point de terminaison extrait la source, enregistre les données de manière persistante, puis relance la recherche avant de répondre. Soumis à un délai propre à chaque route.

Exemple:

true

advertisement_formats

enum<string>[]

Trouve les entreprises ayant au moins une publicité dans l'un de ces formats créatifs.

Options disponibles:

image,

video,

text,

carousel,

dynamic_product,

document,

message,

event,

article,

spotlight,

follow,

job,

engagement

Exemple:

["image", "video"]

reach_tiers

enum<string>[]

Tranche d'impressions de la publicité : lt_1k, 1k_10k, 10k_50k, 50k_100k, 100k_500k, 500k_1m, 1m_plus. Les publicités sans valeur total_impressions ne correspondent jamais ; les slugs inconnus ne correspondent à rien.

Options disponibles:

lt_1k,

1k_10k,

10k_50k,

50k_100k,

100k_500k,

500k_1m,

1m_plus

Exemple:

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

advertisement_active_ads

(integer | null)[]

Nombre minimal et maximal de publicités actuellement actives de l'entreprise, tous pays confondus. Utilisez null pour une borne ouverte, par ex. [1, null] pour « au moins une publicité active ».

Required array length: 2 elements

Exemple:

[1, null]

advertisement_running_ads

(integer | null)[]

Nombre minimal et maximal de publicités de l'entreprise encore diffusées (sans date de fin, ou avec une date de fin dans le futur). Actuellement renseigné uniquement pour les publicités LinkedIn.

Required array length: 2 elements

Exemple:

[1, null]

advertisement_total_ads

(integer | null)[]

Nombre minimal et maximal du total des publicités jamais enregistrées pour l'entreprise, tous pays confondus.

Required array length: 2 elements

Exemple:

[10, null]

advertisement_platform_count

(integer | null)[]

Nombre minimal et maximal de plateformes publicitaires distinctes (linkedin, facebook, google, tiktok, apple) sur lesquelles l'entreprise fait activement de la publicité.

Required array length: 2 elements

Exemple:

[2, null]

advertisement_format_count

(integer | null)[]

Nombre minimal et maximal de formats créatifs publicitaires distincts que l'entreprise diffuse activement.

Required array length: 2 elements

Exemple:

[2, null]

advertisement_impressions_estimate

(integer | null)[]

Nombre minimal et maximal estimé d'impressions publicitaires, cumulé sur tous les pays. Seules les publicités disposant d'une plage d'impressions déclarée sont comptabilisées.

Required array length: 2 elements

Exemple:

[1000, null]

advertisement_country_activity

object

Activité publicitaire pour un pays spécifique. country est obligatoire, et au moins un autre champ doit être renseigné (un pays seul ne correspond à rien). Pour un total tous pays confondus, utilisez plutôt les filtres de premier niveau advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate.

Show child attributes

Exemple:

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

source_types

enum<string>[]

Sources à inclure : linkedin, facebook (meta accepté), google, tiktok, apple. Les valeurs inconnues ne correspondent à rien et sont reprises dans metadata.unsupported_source_types.

Options disponibles:

linkedin,

facebook,

google,

tiktok,

apple

Exemple:

["linkedin", "facebook"]

exclude_source_types

enum<string>[]

Exclut les publicités capturées depuis ces sources. Même vocabulaire que source_types (linkedin, facebook, google, tiktok, apple ; meta est un alias de facebook). Les valeurs inconnues sont ignorées.

Options disponibles:

linkedin,

facebook,

google,

tiktok,

apple

Exemple:

["apple"]

enrichment_mode

enum<string>

défaut:default

Contrôle le comportement de l'enrichissement en temps réel. default renvoie ce qui se trouve déjà dans la base de données, et ne déclenche l'enrichissement que lorsque l'ensemble de résultats est vide et que is_realtime_enrichment est activé. latest contourne le cache et force un nouveau passage d'enrichissement sur les enregistrements source les plus récents à chaque appel — il déclenche l'enrichissement de lui-même, sans nécessiter aucun autre indicateur.

Options disponibles:

default,

latest

Exemple:

"latest"

per_page

integer

défaut:25

Enregistrements par page. Par défaut 25, ce qui constitue également le plafond sur la plupart des forfaits — la limite correspond au max_search_per_page de votre abonnement, renvoyé par Profile. Le dépasser renvoie HTTP 416 avec le code 41676 (ou 41613 pour la recherche d'entreprises et de personnes), et non un ensemble de résultats tronqué.

Plage requise: x <= 25

Exemple:

25

page

integer

défaut:1

Numéro de page, à partir de 1. Le plafond correspond au max_search_page de votre abonnement (max_company_search_page pour la recherche d'entreprises), renvoyé par Profile. Le dépasser renvoie HTTP 416.

Exemple:

1

is_ascending_order

boolean

défaut:false

Sens de tri. Les résultats sont renvoyés du plus récent au plus ancien par défaut ; définissez true pour du plus ancien au plus récent. Il n'y a pas de sort_by sur cet endpoint — la clé de tri est fixe et indiquée dans la description de l'endpoint.

Exemple:

false

publisher_platforms

enum<string>[]

Filtre les publicités Facebook/Meta selon la surface de plateforme sur laquelle elles ont été diffusées. En minuscules et insensible à la casse. S'applique uniquement à la source facebook (les autres sources sont mono-plateforme).

Options disponibles:

facebook,

instagram,

messenger,

threads,

audience_network

Exemple:

["facebook", "instagram"]

exclude_publisher_platforms

enum<string>[]

Exclut les publicités Facebook/Meta diffusées sur ces surfaces de plateforme.

Options disponibles:

facebook,

instagram,

messenger,

threads,

audience_network

Exemple:

["audience_network"]

is_include_unlinked_companies

boolean

défaut:false

Inclut les publicités non encore liées à une entreprise résolue (publicités de la couche brute, par ex. publicités frauduleuses ou de pages éphémères). Par défaut à false, ce qui ne renvoie que les publicités attribuées à une entreprise.

Exemple:

true

Réponse

Réponse réussie contenant les détails de la recherche de publicités d'entreprises.

metadata

object

Contexte de la requête.

Show child attributes

data

object

Show child attributes

Dernière modification le 4 septembre 2026

Documentation API

Point de terminaison

Recherche d'annonces publicitaires d'entreprise

Autorisations

Corps

Réponse