Skip to main content
POST
企業のシグナルイベント

承認

pubrio-api-key
string
header
必須

API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの 設定 画面から発行できます。

ボディ

application/json
domain_search_id
string<uuid>
必須

企業検索系の処理を紐づけるための一意の識別子です。

signal_types
enum<string>[]

特定のシグナルの種類に絞り込みます。定義とティアについてはナレッジベースのシグナルタイプカタログを参照してください(DNSINFRA は Premier ティアのシグナルです)。

利用可能なオプション:
AD,
NEWS,
DNS,
INFRA,
PARTNER,
EVENT_PLUS,
EXEC,
OFFICE,
HIRE,
SCALE,
PRODUCT
:
country_codes
string[]

任意。フィードを 1 つ以上の海外市場(ISO 3166-1 alpha-2、例:["JP","SG"])に絞り込みます。省略時はすべての海外市場が対象です(本国市場は常に除外)。

:
transitioned_dates
string<date>[]

シグナル/遷移ウィンドウの ISO [from, to] 日付範囲です。window_days の両方が指定された場合はこちらが優先されます。

:
window_days
integer
デフォルト:90

任意。イベントのローリングウィンドウの日数。本パラメータと transitioned_dates のいずれも指定しない場合、デフォルトで 90 日(標準の表示ウィンドウ)が使用されます。両方を指定した場合は transitioned_dates が優先されます。

:

90

query
string

自社が販売しているもの、またはこの企業を評価する際の理想的な買い手像を、自然な文章で記述します。AI の summary の根拠としてのみ使用されます(is_explain_match を参照)。企業検索とは異なり、ここではフィルター条件には解釈されません。

:

"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."

is_explain_match
boolean

true かつ query が指定されている場合、data.summary に、この企業の拡大活動を query に照らして解釈した単一の AI 要約が返されます。企業の実際のシグナルに基づき、[n] の引用付きです。企業検索の企業ごとの match_summary とは異なり、この要約はウィンドウ内の企業の全シグナル(全市場・すべてのシグナル)から生成されるため、page / per_page に関わらず安定しています。

:

true

domain
string

企業ルックアップに使用する会社ドメインです。www.pubrio.comhttps://docs.pubrio.com/ のような値が指定された場合、自動的に pubrio.com に正規化されます。

:

"pubrio.com"

linkedin_url
string

企業の LinkedIn 公式ページを指す完全な URL です。値は http で始まり、linkedin.com/company/ を含んでいる必要があります。

:

"https://www.linkedin.com/company/pubrio"

page
integer
デフォルト:1

ページ番号(1 から開始)。上限はサブスクリプションの max_search_page(企業検索では max_company_search_page)で、Profile から取得できます。超過すると HTTP 416 が返ります。

:

1

per_page
integer
デフォルト:25

1 ページあたりの件数。既定は 25 で、多くのプランではこれが上限でもあります。制限値はサブスクリプションの max_search_per_page で、Profile から取得できます。超過すると結果が丸められるのではなく、HTTP 416 とコード 41676(企業・人物検索では 41613)が返ります。

必須範囲: x <= 25
:

25

レスポンス

200 - application/json

ページネーションされたシグナルイベントです。 is_explain_match が true かつ query が指定されている場合、data.summary には企業の全シグナルをクエリに照らして生成した AI 要約({ text, citations })が入ります。それ以外は null です。

metadata
object
data
any