公司广告检索 - Pubrio Documentation

搜索公司广告

curl --request POST \
  --url https://api.pubrio.com/companies/advertisements/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "target_locations": [
    "TW",
    "AE",
    "NO"
  ],
  "exclude_target_locations": [
    "IS",
    "GB",
    "FR",
    "IE",
    "ES"
  ],
  "search_terms": [
    "pubrio"
  ],
  "headlines": [
    "ASUS",
    "iPhone"
  ],
  "filter_conditions": [
    {
      "key": "exclude_target_locations",
      "operator": "or"
    }
  ],
  "start_dates": [
    "2025-12-01",
    "2025-12-01"
  ],
  "end_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "company_locations": [
    "US",
    "SG",
    "CN"
  ],
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "is_realtime_enrichment": true,
  "source_types": [
    "linkedin",
    "facebook"
  ],
  "enrichment_mode": "latest",
  "per_page": 25,
  "page": 1,
  "profile_id": 123
}
'

{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 694356,
      "total_pages": 27775,
      "total_display_pages": 250,
      "is_timeout": false
    },
    "advertisements": [
      {
        "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"
        }
      },
      "..."
    ]
  }
}

POST

companies

advertisements

搜索公司广告

curl --request POST \
  --url https://api.pubrio.com/companies/advertisements/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "target_locations": [
    "TW",
    "AE",
    "NO"
  ],
  "exclude_target_locations": [
    "IS",
    "GB",
    "FR",
    "IE",
    "ES"
  ],
  "search_terms": [
    "pubrio"
  ],
  "headlines": [
    "ASUS",
    "iPhone"
  ],
  "filter_conditions": [
    {
      "key": "exclude_target_locations",
      "operator": "or"
    }
  ],
  "start_dates": [
    "2025-12-01",
    "2025-12-01"
  ],
  "end_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "company_locations": [
    "US",
    "SG",
    "CN"
  ],
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "is_realtime_enrichment": true,
  "source_types": [
    "linkedin",
    "facebook"
  ],
  "enrichment_mode": "latest",
  "per_page": 25,
  "page": 1,
  "profile_id": 123
}
'

{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 694356,
      "total_pages": 27775,
      "total_display_pages": 250,
      "is_timeout": false
    },
    "advertisements": [
      {
        "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"
        }
      },
      "..."
    ]
  }
}

授权

pubrio-api-key

string

header

必填

一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在设置部分创建该令牌。

请求体

application/json

target_locations

string[]

通过国家代码筛选到达特定地点的广告。用于查找在特定国家展示的广告。与 filter_conditions 配合使用，操作符为 OR - 广告必须至少定位到指定地点中的一个。

示例:

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

exclude_target_locations

string[]

通过国家代码排除定位特定地点的广告。用于筛除在特定国家展示的广告。当在 filter_conditions 中与操作符 'or' 一起使用时，广告必须不定位到任何被排除的地点。

示例:

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

search_terms

string[]

用于筛选结果的关键词字符串列表。

示例:

["pubrio"]

headlines

string[]

用于筛选搜索结果的标题列表。

示例:

["ASUS", "iPhone"]

filter_conditions

object[]

广告搜索的高级筛选选项。指定条件以优化广告搜索端点的搜索结果。

Show child attributes

start_dates

string<date>[]

用于筛选搜索结果的开始日期列表。

示例:

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

end_dates

string<date>[]

用于筛选搜索结果的结束日期列表。

示例:

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

company_locations

string[]

公司总部所在地。更多信息请参见筛选器标签下的 location 端点。

示例:

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

companies

string<uuid>[]

用于公司和人员检索操作的一组唯一标识符（domain_search_id）列表。

domains

string[]

用于公司和人员检索操作的公司域名列表。如果收到的地址为 www.pubrio.com 或 https://docs.pubrio.com/，系统会自动转换为 pubrio.com 进行处理。

示例:

["pubrio.com"]

linkedin_urls

string[]

LinkedIn 公司主页的完整 URL。URL 需以 http 开头且包含 linkedin.com/company/。

示例:

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

is_realtime_enrichment

boolean

默认值:false

为单一公司范围的查询（通过 domain_search_id、domains 或 linkedin_urls 过滤）启用实时数据增强。当初次搜索返回 0 条结果时，系统会抓取来源数据、写入记录后重新执行搜索再返回。受每条路由的超时限制约束。

示例:

true

source_types

enum<string>[]

限制哪些广告来源类型可参与实时数据增强。省略时默认包含全部来源。仅在实时增强实际触发时生效——即当设置了 is_realtime_enrichment 或 enrichment_mode: latest 时。

可用选项:

linkedin,

facebook,

google

示例:

["linkedin", "facebook"]

enrichment_mode

enum<string>

默认值:default

控制实时数据增强行为。default 返回数据库中已有的数据，仅当结果为空且设置了 is_realtime_enrichment 时才触发增强。latest 会绕过缓存，并在每次调用时针对最新的源记录强制执行重新增强——即使未设置其他任何标志，它本身也会触发增强。

可用选项:

default,

latest

示例:

"latest"

per_page

integer

每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。

示例:

25

page

integer

要检索的数据页码。

示例:

1

profile_id

integer

可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。

更多信息请参见团队标签下的 user details 端点。

响应

包含公司广告搜索详细信息的成功响应。

data

object

响应信息取决于具体接口。

公司新闻检索用户检索