Skip to main content
POST
搜索公司新闻

授权

pubrio-api-key
string
header
必填

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

请求体

application/json
locations
string[]

新闻内容本身所涉及的国家,从文章正文中识别(ISO 3166-1 alpha-2)。文章未提及地点时为空。如需按文中公司的总部所在国筛选,请使用 company_locations。

示例:
company_locations
string[]

文章所提及公司的总部所在国(ISO 3166-1 alpha-2),而不是新闻事件发生的地点;后者请使用 locations。

示例:
companies
string<uuid>[]

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

news_search_id
string<uuid>

仅返回这一条记录。适合在不翻页的情况下重新获取你此前存储的某一行。

示例:

"4110b929-17cd-42aa-a159-906ead0c9b56"

domains
string[]

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

示例:
linkedin_urls
string[]

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

示例:
search_term
string

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

示例:

"pubrio"

search_terms
string[]

用于过滤新闻文章的关键词字符串数组。每个词与文章内容进行匹配。使用 search_term 传入单个字符串,或使用 search_terms 传入多个关键词。

示例:
exclude_search_terms
string[]

排除提及其中任意一个词的文章,匹配方式与 search_terms 相同。也可使用 exclude_keywords 作为参数名。

示例:
sources
string[]

仅返回来自这些发布方的文章。请使用发布方的域名,例如 bbc.co.uk,即每篇文章 source 字段中的值。也可以传入完整 URL 或带 www. 的地址。

示例:
exclude_sources
string[]

排除来自这些发布方的文章。格式与 sources 相同。没有记录发布方的文章会被保留。

示例:
categories
string[]

category slugs 列表,用于搜索特定新闻类别。要获取 slug,请调用筛选器标签下的 news categories 端点。

示例:

news_gallery_id 列表,用于搜索特定新闻库。要获取ID,请调用筛选器标签下的 news galleries 端点。

published_dates
string[]

发布时间的时间范围。最大值为当天。 日期边界遵循你的工作区时区。

示例:
published_at
string<date-time>

在此时刻当时或之后发布(UTC)。可传日期或 ISO 时间戳。published_dates 是闭区间形式,使用你的工作区时区。

示例:

"2026-09-01T00:00:00Z"

per_page
integer
默认值:25

每页记录数。默认 25,在大多数套餐下这也是上限 —— 该限制即订阅中的 max_search_per_page,可通过 Profile 获取。超出会返回 HTTP 416 及错误码 41676(公司与人物搜索为 41613),而不是自动截断结果。

必填范围: x <= 25
示例:

25

page
integer
默认值:1

页码,从 1 开始。上限为订阅中的 max_search_page(公司搜索为 max_company_search_page),可通过 Profile 获取。超出会返回 HTTP 416。

示例:

1

is_ascending_order
boolean
默认值:false

排序方向。默认按最新在前返回;设为 true 则最旧在前。此端点没有 sort_by——排序键是固定的,见端点说明。

示例:

false

news_galleries
string[]

用于按画廊过滤新闻的 画廊 slug 列表。要查找 slug,请调用过滤器选项卡下的 news galleries 端点。

示例:
news_languages
string[]

用于按语言过滤新闻的 locale_code 值列表。要查找可用代码,请调用过滤器选项卡下的 news languages 端点。

示例:
is_expansion_signal_available
boolean

设为 true 时,会为每条新闻附加解析出的扩张信号(expansion_signals),并启用 expansion_signal_types / expansion_signal_polarities 筛选。若追求最快的搜索速度,请不要设置该参数——只有在开启此标志时才会加入扩张信号的关联查询。

expansion_signal_types
enum<string>[]

仅返回产生了下列类型之一的扩张信号的新闻(大写 slug)。需要 is_expansion_signal_available: true。仅包含未知 slug 的列表不会匹配任何结果。

可用选项:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
示例:
expansion_signal_polarities
enum<string>[]

仅返回其扩张信号带有下列极性之一的新闻。需要 is_expansion_signal_available: true。与 expansion_signal_types 之间为 AND 关系。

可用选项:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
示例:

响应

包含相关详细信息的成功响应。

metadata
object

请求上下文。

data
object
最后修改于 2025年6月9日