新闻搜索

新闻搜索返回 Pubrio 已分类的新闻文章，每篇文章一行。每一行关联到文章提及的所有公司，携带一个分类 slug（acquires、partners_with、receives_financing 等），并可按需附带该文章产生的扩张信号。

curl -X POST https://api.pubrio.com/companies/news/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["stripe.com"],
    "categories": ["partners_with", "launches"],
    "published_dates": ["2026-08-01", "2026-09-04"],
    "per_page": 25
  }'

适用场景

客户情报——某家公司本月发生了什么，按分类整理。
基于触发事件的获客——在你销售所在的国家和语言中，所有宣布融资或收购的公司。
信号证据——配合 is_expansion_signal_available: true，查看哪些文章产生了哪些扩张信号。

需要计数和分类明细时请使用新闻洞察。要在文章到达时收到通知，请创建一个 signal_types: ["news"] 的监控器。

限定到公司

键	值	说明
`domains`	`["stripe.com"]`	匹配提及该公司的文章，而不仅是以它为主题的文章
`linkedin_urls`	`["https://www.linkedin.com/company/stripe"]`	仅限公司主页
`companies`	`["5378845d-…"]`	`domain_search_id` 值

不指定公司的搜索也可以——{"categories": ["acquires"], "locations": ["SG"]}——会返回该分类的整个索引，最新在前。

筛选器

分类与画廊

键	类型	匹配
`categories`	`string[]`	来自新闻分类的分类 slug。匹配任一列出的 slug。
`news_galleries`	`string[]`	来自新闻画廊的画廊 slug。
`news_gallery_ids`	`uuid[]`	同样的画廊，按 id 指定。
`news_languages`	`string[]`	来自新闻语言的 ISO 639-1 代码。

文本

键	类型	匹配
`search_term`	`string`	针对标题和摘要的自由文本，支持任意受支持的语言。
`search_terms`	`string[]`	多个词，任一匹配即可。

日期

键	类型	匹配
`published_dates`	`[from, to]`	发布日期窗口，闭区间。日期边界遵循你的工作区时区。
`published_at`	日期或 ISO 时间戳	在该时刻当时或之后发布，按 UTC 比较。

地点

键	类型	匹配
`locations`	`string[]`	文章涉及的国家（行中的 `country_codes`）。
`company_locations`	`string[]`	被提及公司的总部所在国家。

扩张信号

键	类型	匹配
`is_expansion_signal_available`	`boolean`	为每行附加 `expansion_signals` 并启用下面两个筛选器。不需要时不要设置，搜索最快。
`expansion_signal_types`	`string[]`	`HIRE`、`PARTNER`、`PRODUCT`、`SCALE` 等。需要上面的标志。
`expansion_signal_polarities`	`string[]`	`expansion`、`contraction_leading`、`contraction_confirming`、`contraction_lagging`。

分页与排序

键	默认值	说明
`per_page` / `page`	25 / 1	受套餐限制；见 `total_display_pages`。
`is_ascending_order`	`false`	行按 `published_at` 排序，最新在前，无日期的文章排最后。`true` 则改为最旧在前。

一行数据的样子

{
  "news_id": "76886b56-3418-476a-a531-fff18deb29db",
  "news_search_id": "4d950aea-e2bb-4367-869b-c34e834a82ec",
  "title": "PayPal Rejects Takeover, Rated Buy",
  "summary": "…",
  "url": "https://seekingalpha.com/article/4942660-…",
  "source": "seekingalpha.com",
  "image_url": "https://static.seekingalpha.com/…",
  "language": "en",
  "published_at": "2026-09-03T08:54:21.000000Z",
  "last_modified": "2026-09-03T09:20:55.189Z",
  "category": "receives_financing",
  "news_category_name": "Funding Announcements",
  "news_galleries": [{ "news_gallery_id": "342f2eb1-…", "slug": "general-business", "name": "General Business" }],
  "country_codes": null,
  "company_country_codes": ["US"],
  "locations": null,
  "domains": ["paypal.com", "stripe.com"],
  "companies": [
    { "domain_search_id": "5378845d-…", "company_name": "Stripe", "domain": "stripe.com", "country_code": "US", "…": "…" },
    { "domain_search_id": "b03b312a-…", "company_name": "PayPal", "domain": "paypal.com", "country_code": "US", "…": "…" }
  ]
}

companies 和 domains 是平行数组，列出所有被提及的公司，因此限定到 stripe.com 的搜索可能返回一篇以 PayPal 为主要主题的文章。如果你需要以你的公司为主题的文章，请在客户端按 domains 过滤。
country_codes 是文章涉及的国家；company_country_codes 是被提及公司所在的国家。locations 筛选前者。
news_category_name 按请求的 language 本地化；category 是稳定的 slug。
设置 is_expansion_signal_available: true 后，每行会增加 expansion_signals: [{ signal_type_slug, signal_strength_slug, polarity, country_code, domain_search_id, event_date }]。

`metadata.ignored_fields`

端点无法识别的请求键都会被丢弃并列在这里。"categorys" 会返回整个索引并带上 ignored_fields: ["categorys"]，而不是报错。

示例

日语的融资新闻
单个客户的扩张证据
每日摘要

cURL

curl -X POST https://api.pubrio.com/companies/news/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "categories": ["receives_financing"],
    "news_languages": ["ja"],
    "published_dates": ["2026-08-01", "2026-09-04"],
    "per_page": 25
  }'

cURL

curl -X POST https://api.pubrio.com/companies/news/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["stripe.com"],
    "is_expansion_signal_available": true,
    "expansion_signal_types": ["HIRE", "PARTNER", "PRODUCT", "OFFICE"],
    "expansion_signal_polarities": ["expansion"],
    "per_page": 25
  }'

现在每一行都解释了一个你原本只能在公司扩张详情中看作阶段的信号。

Python

import os, requests
from datetime import datetime, timedelta, timezone

since = (datetime.now(timezone.utc) - timedelta(days=1)).strftime("%Y-%m-%dT%H:%M:%SZ")
body = requests.post(
    "https://api.pubrio.com/companies/news/search",
    headers={"pubrio-api-key": os.environ["PUBRIO_API_KEY"]},
    json={"domains": ["stripe.com", "adyen.com"], "published_at": since, "per_page": 25},
).json()

for a in body["data"]["news"]:
    subjects = ", ".join(c["company_name"] for c in a["companies"])
    print(f'[{a["category"]}] {a["title"]} — {subjects}')

published_at 按 UTC 比较，因此滚动 24 小时的时间戳比日历日期更安全。

新闻搜索参考

所有参数和响应字段。

新闻洞察

单家公司在某个时间窗内的提及、主题和来源。

新闻分类

可用于筛选的分类 slug。

扩张信号

信号类型和极性的含义。

监控

搜索

筛选器

人员

扩张

适用场景

限定到公司

筛选器

分类与画廊

文本

日期

地点

扩张信号

分页与排序

一行数据的样子

`metadata.ignored_fields`

示例

相关

新闻搜索参考

新闻洞察

新闻分类

扩张信号

​适用场景

​限定到公司

​筛选器

​分类与画廊

​文本

​日期

​地点

​扩张信号

​分页与排序

​一行数据的样子

​metadata.ignored_fields

​示例

​相关

新闻搜索参考

新闻洞察

新闻分类

扩张信号

适用场景

限定到公司

筛选器

分类与画廊

文本

日期

地点

扩张信号

分页与排序

一行数据的样子

`metadata.ignored_fields`

示例

相关