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>

このレコード 1 件のみを返します。以前保存した行をページングせずに再取得するのに便利です。

例:

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

domains
string[]

企業および人物検索に使用する会社ドメインの一覧です。www や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。

例:
linkedin_urls
string[]

企業の LinkedIn 公式ページを指す完全な 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[]

特定のニュースカテゴリを検索するためのカテゴリスラッグ一覧です。スラッグは 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

1 ページあたりの件数。既定は 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[]

ギャラリーでニュースをフィルタリングするための gallery 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>[]

これらのタイプ(大文字のスラッグ)のいずれかのエクスパンションシグナルを生成したニュースのみを返します。is_expansion_signal_available: true が必要です。未知のスラッグだけのリストは何にも一致しません。

利用可能なオプション:
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年12月8日