ニュース検索

ニュース検索は Pubrio が分類したニュース記事を 1 件 1 行で返します。各行は記事が言及するすべての企業に紐づき、カテゴリスラッグ（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[]`	ニュースカテゴリのカテゴリスラッグ。列挙したいずれか。
`news_galleries`	`string[]`	ニュースギャラリーのギャラリースラッグ。
`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` を付与し、下の 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` で古い順になります。

行の例

{
  "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"] 付きで返します。

レシピ

日本語の資金調達ニュース
1 社の拡大の根拠
日次ダイジェスト

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 時間のタイムスタンプの方が安全です。