> ## 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.

# 新闻搜索

> 按分类、国家、语言和日期查找公司新闻，每篇文章都关联到它提及的公司——并可选择关联到它产生的扩张信号。

[新闻搜索](/cn/api-reference/endpoint/companies/news_search)返回 Pubrio 已分类的新闻文章，每篇文章一行。每一行关联到文章提及的**所有**公司，携带一个分类 slug（`acquires`、`partners_with`、`receives_financing` 等），并可按需附带该文章产生的扩张信号。

```bash theme={null}
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`，查看哪些文章产生了哪些[扩张信号](/cn/knowledge-base/concepts/expansion-signals)。

需要计数和分类明细时请使用[新闻洞察](/cn/api-reference/endpoint/companies/news_insights)。要在文章到达时收到通知，请创建一个 `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[]` | 来自[新闻分类](/cn/api-reference/endpoint/news/categories)的分类 slug。匹配任一列出的 slug。 |
| `news_galleries`   | `string[]` | 来自[新闻画廊](/cn/api-reference/endpoint/news/galleries)的画廊 slug。               |
| `news_gallery_ids` | `uuid[]`   | 同样的画廊，按 id 指定。                                                             |
| `news_languages`   | `string[]` | 来自[新闻语言](/cn/api-reference/endpoint/news/languages)的 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` 则改为最旧在前。 |

## 一行数据的样子

```json theme={null}
{
  "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"]`，而不是报错。

## 示例

<Tabs>
  <Tab title="日语的融资新闻">
    ```bash cURL theme={null}
    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
      }'
    ```
  </Tab>

  <Tab title="单个客户的扩张证据">
    ```bash cURL theme={null}
    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
      }'
    ```

    现在每一行都解释了一个你原本只能在[公司扩张详情](/cn/api-reference/endpoint/expansions/company_lookup)中看作阶段的信号。
  </Tab>

  <Tab title="每日摘要">
    ```python Python theme={null}
    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 小时的时间戳比日历日期更安全。
  </Tab>
</Tabs>

## 相关

<CardGroup cols={2}>
  <Card title="新闻搜索参考" icon="code" href="/cn/api-reference/endpoint/companies/news_search">
    所有参数和响应字段。
  </Card>

  <Card title="新闻洞察" icon="chart-column" href="/cn/api-reference/endpoint/companies/news_insights">
    单家公司在某个时间窗内的提及、主题和来源。
  </Card>

  <Card title="新闻分类" icon="tags" href="/cn/api-reference/endpoint/news/categories">
    可用于筛选的分类 slug。
  </Card>

  <Card title="扩张信号" icon="globe" href="/cn/knowledge-base/concepts/expansion-signals">
    信号类型和极性的含义。
  </Card>
</CardGroup>