> ## 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.
# ニュース検索
> カテゴリ、国、言語、日付で企業ニュースを検索します。各記事は言及している企業に紐づき、任意でその記事が生成した拡大シグナルにも紐づきます。
[ニュース検索](/jp/api-reference/endpoint/companies/news_search)は Pubrio が分類したニュース記事を 1 件 1 行で返します。各行は記事が言及する**すべて**の企業に紐づき、カテゴリスラッグ（`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` で、どの記事がどの[拡大シグナル](/jp/knowledge-base/concepts/expansion-signals)を生成したかを確認する。
件数やカテゴリ内訳が必要な場合は[ニュースインサイト](/jp/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[]` | [ニュースカテゴリ](/jp/api-reference/endpoint/news/categories)のカテゴリスラッグ。列挙したいずれか。 |
| `news_galleries` | `string[]` | [ニュースギャラリー](/jp/api-reference/endpoint/news/galleries)のギャラリースラッグ。 |
| `news_gallery_ids` | `uuid[]` | 同じギャラリーを id で指定。 |
| `news_languages` | `string[]` | [ニュース言語](/jp/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` を付与し、下の 2 つのフィルターを有効にします。最速の検索にはオフのままにしてください。 |
| `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` は安定したスラッグです。
* `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"]` 付きで返します。
## レシピ
```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
}'
```
```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
}'
```
各行が、[企業拡大詳細](/jp/api-reference/endpoint/expansions/company_lookup)ではステージとしてしか見えないシグナルの根拠を示します。
```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 時間のタイムスタンプの方が安全です。
## 関連
すべてのパラメーターとレスポンスフィールド。
1 社の期間内の言及数、トピック、ソース。
フィルターに使えるカテゴリスラッグ。
シグナルタイプと極性の意味。