> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # 公司广告检索 > 搜索符合指定条件的公司投放的广告。 对于 `facebook` 来源的广告，`source_type` 涵盖整个 Meta 广告库——Facebook、Instagram、Messenger、Threads 和 Audience Network——可使用 `publisher_platforms` 按版位筛选。`destination_url` 返回解析后的落地页（`fb.me` 等 Facebook 跳转包装链接会被还原为真实的转化链接），而 `raw_link_url` 则保留原始捕获的链接。 ## OpenAPI ````yaml cn-openapi POST /companies/advertisements/search openapi: 3.0.0 info: description: >- Pubrio API 提供市场扩张情报——实时捕捉企业进入新市场的信号，以及其底层的公司与人员数据。可搜索、查找并丰富账户与联系人信息，并订阅覆盖 200+ 市场、带类型与日期的动向信号。 version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/zh-CN/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/zh-CN/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 工作区配置信息和使用统计 - name: Enrichment description: 通过详细的 B2B 数据丰富人员和公司记录 - name: Lookalike description: 查找与指定公司相似的公司 - name: Search description: 使用筛选条件搜索人员、公司、职位、新闻和广告 - name: Lookup description: 查找特定人员、公司、职位、新闻、广告和技术的详细信息 - name: LinkedIn description: 通过 LinkedIn 个人资料 URL 查找人员和公司数据 - name: Redeem description: 兑换积分以解锁人员联系方式（单个和批量） - name: Channels description: 管理外展渠道模板（创建、更新、删除、列表） - name: Monitor description: 创建和管理数据监控，包括 Webhook、统计和处理 - name: Filters description: 获取搜索参数的可用筛选值（技术、地点、垂直领域等） - name: API Keys description: 查看 API 密钥的请求日志和使用情况分析 - name: Insights description: 公司的信号聚合洞察(招聘、新闻、广告)。 - name: Export description: 批量数据导出(消耗积分)。 - name: Expansion description: 公司市场扩张情报:信号、阶段、市场与导出。 externalDocs: description: Pubrio API 用于搜索、预览和增强联系人及账户信息。Pubrio 数据库提供丰富的 B2B 联系人和销售情报数据。 url: https://docs.pubrio.com paths: /companies/advertisements/search: post: tags: - Search summary: 搜索公司广告 description: >- 搜索符合指定条件的公司投放的广告。 对于 `facebook` 来源的广告，`source_type` 涵盖整个 Meta 广告库——Facebook、Instagram、Messenger、Threads 和 Audience Network——可使用 `publisher_platforms` 按版位筛选。`destination_url` 返回解析后的落地页（`fb.me` 等 Facebook 跳转包装链接会被还原为真实的转化链接），而 `raw_link_url` 则保留原始捕获的链接。 operationId: companies_search_advertisements parameters: [] requestBody: required: true content: application/json: schema: type: object properties: target_locations: $ref: '#/components/schemas/target_locations' exclude_target_locations: $ref: '#/components/schemas/exclude_target_locations' search_terms: $ref: '#/components/schemas/search_terms' headlines: $ref: '#/components/schemas/headlines' filter_conditions: $ref: '#/components/schemas/ads_filter_conditions' start_dates: $ref: '#/components/schemas/start_dates' end_dates: $ref: '#/components/schemas/end_dates' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' source_types: $ref: '#/components/schemas/advertisement_source_types' enrichment_mode: $ref: '#/components/schemas/advertisement_enrichment_mode' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' profile_id: $ref: '#/components/schemas/profile_id' publisher_platforms: $ref: '#/components/schemas/advertisement_publisher_platforms' exclude_publisher_platforms: $ref: >- #/components/schemas/advertisement_exclude_publisher_platforms is_include_unlinked_companies: $ref: >- #/components/schemas/advertisement_is_include_unlinked_companies responses: '200': description: 包含公司广告搜索详细信息的成功响应。 content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: 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 - 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 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- 通过国家代码筛选到达特定地点的广告。用于查找在特定国家展示的广告。与 `filter_conditions` 配合使用，操作符为 OR - 广告必须至少定位到指定地点中的一个。 exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- 通过国家代码排除定位特定地点的广告。用于筛除在特定国家展示的广告。当在 `filter_conditions` 中与操作符 'or' 一起使用时，广告必须不定位到任何被排除的地点。 search_terms: type: array items: type: string example: - pubrio description: 用于筛选结果的关键词字符串列表。 headlines: type: array items: type: string example: - ASUS - iPhone description: 用于筛选搜索结果的标题列表。 ads_filter_conditions: type: array items: type: object properties: key: type: string enum: - target_locations - exclude_target_locations example: exclude_target_locations description: 指定应用操作符的筛选键。 operator: type: string enum: - or - and example: or description: 要应用的逻辑操作符。使用 'or' 匹配排除任何指定地点的广告，或使用 'and' 匹配排除所有指定地点的广告。 description: 广告搜索的高级筛选选项。指定条件以优化广告搜索端点的搜索结果。 start_dates: type: array items: type: string format: date example: - '2025-12-01' - '2025-12-01' description: 用于筛选搜索结果的开始日期列表。 end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: 用于筛选搜索结果的结束日期列表。 company_locations: type: array items: type: string example: - US - SG - CN description: 公司总部所在地。更多信息请参见筛选器标签下的 `location` 端点。 companies: type: array items: type: string format: uuid description: 用于公司和人员检索操作的一组唯一标识符（domain_search_id）列表。 domains: type: array items: type: string example: - pubrio.com description: >- 用于公司和人员检索操作的公司域名列表。如果收到的地址为 `www.pubrio.com` 或 `https://docs.pubrio.com/`，系统会自动转换为 `pubrio.com` 进行处理。 company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: LinkedIn 公司主页的完整 URL。URL 需以 `http` 开头且包含 `linkedin.com/company/`。 is_realtime_enrichment: type: boolean default: false example: true description: >- 为单一公司范围的查询（通过 `domain_search_id`、`domains` 或 `linkedin_urls` 过滤）启用实时数据增强。当初次搜索返回 0 条结果时，系统会抓取来源数据、写入记录后重新执行搜索再返回。受每条路由的超时限制约束。 advertisement_source_types: type: array items: type: string enum: - linkedin - facebook - google example: - linkedin - facebook description: >- 限制哪些广告来源类型可参与实时数据增强。省略时默认包含全部来源。仅在实时增强实际触发时生效——即当设置了 `is_realtime_enrichment` 或 `enrichment_mode: latest` 时。 advertisement_enrichment_mode: type: string enum: - default - latest default: default example: latest description: >- 控制实时数据增强行为。`default` 返回数据库中已有的数据，仅当结果为空且设置了 `is_realtime_enrichment` 时才触发增强。`latest` 会绕过缓存，并在每次调用时针对最新的源记录强制执行重新增强——即使未设置其他任何标志，它本身也会触发增强。 per_page: type: integer example: 25 description: 每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。 page: type: integer example: 1 description: 要检索的数据页码。 profile_id: type: integer description: >- 可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。 更多信息请参见团队标签下的 `user details` 端点。 advertisement_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - facebook - instagram description: 按投放的平台版位筛选 Facebook/Meta 广告。使用小写，且不区分大小写。仅适用于 `facebook` 来源（其他来源为单一平台）。 advertisement_exclude_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - audience_network description: 排除在这些平台版位投放的 Facebook/Meta 广告。 advertisement_is_include_unlinked_companies: type: boolean default: false example: true description: 包含尚未关联到已识别公司的广告（原始层广告，例如诈骗或临时专页广告）。默认为 false，仅返回已关联公司的广告。 data: type: object nullable: true description: 响应信息取决于具体接口。 responses: general_error: description: 请求错误。请求格式不正确或包含无效参数。请检查错误代码和消息以获取详细信息。 content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 错误及代码会根据不同场景有所不同，详情请参阅文档。 type: string details: type: object rate_limit_error: description: 超出速率限制。在给定时间段内发送了过多请求。请在速率限制窗口重置后重试。 content: application/json: schema: required: - error type: object properties: error: example: 请求频率超出限制。请稍后再试。 type: string server_error: description: 内部服务器错误。服务器发生意外错误。如果错误持续存在，请联系支持团队。 content: application/json: schema: required: - error type: object properties: error: example: 服务器在处理请求时遇到了未预料的异常。 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- 一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 [设置](https://dashboard.pubrio.com/#/settings/) 部分创建该令牌。 in: header ````