Skip to main content
POST
企業エクスパンション詳細

承認

pubrio-api-key
string
header
必須

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

ボディ

application/json
domain_search_id
string<uuid>
必須

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

country_code
string

ISO 3166-1 alpha-2(cca2)国コードによるターゲット市場。省略すると、その企業の最もアクティブな単一市場が自動的に選択されます。すべての市場の市場横断ビューが必要な場合は is_all_markets を設定してください。

:

"US"

is_all_markets
boolean

単一市場ではなく、1 回の呼び出しで企業の全市場にわたる拡大状況全体を返します。true の場合、country_code は無視され、本国市場を特定できる場合はシグナル集計から除外され、data は企業レベルのサマリー(主要段階、シグナル総数、期間、最高拡大スコア)になり、markets_summary にすべての市場が列挙されます。デフォルトは false です。

:

false

signal_type
enum<string>

返却するシグナルを単一のタイプに絞り込みます。

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

"EXEC"

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 を指定した場合、summary は現在のスコープ(選択した市場、または is_all_markets が true のときは全ての海外市場)におけるこの企業の拡大活動を、あなたの query に照らした 1 つの AI 要約として返します。企業の実シグナルに基づき [n] 引用付き。

:

true

window_days
integer
デフォルト:90

任意。AI summary のフィードを区切るローリングウィンドウ(日数)。本パラメータと transitioned_dates のいずれも指定しない場合は既定で 90。ページネーションされる signals リスト(全履歴)には影響しません。

:

90

transitioned_dates
string<date>[]

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

:
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"

is_include_established
boolean

established 段階(アクティブな拡大シグナルを持たない長期事業者)を含めます。デフォルトは false です。

:

false

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

is_include_metadata
boolean

詳細ペイロード全体を返します。API キーによるリクエストは既定で軽量です。これが true でない限り、model ブロック、信頼度の値(企業拡大詳細の stage.confidenceother_markets[] およびランキングの markers[]confidence_score)、established_min / share_of_detected / has_known_office の各フィールドはいずれも省略されます。

:

true

summary_only
boolean

ステージサマリーのブロック(datacompanymarkets_summarysignal_weekly_totalsrecent_signalsexpansion_scoresummary)のみを返し、シグナル一覧とその集計をスキップします。ヒーロー/ヘッダー表示に適し、コストを大幅に抑えられます。

:

true

markets_summary_full
boolean

上限が適用された other_markets に加えて、完全な市場ランキングセットを markets_summary として含めます。

:

true

レスポンス

200 - application/json

特定市場における企業の詳細です。

metadata
object
data
any
signals
object[]

この企業/市場ペアの根拠となるシグナル行(証拠リスト、ページネーション対応)。ページサイズと合計は metadata.pagination を参照してください。

summary
object

当該ペアの 1 行ステージサマリー。1 ページ目のみ返されます。

company
object

企業の基本情報 — 名称、ドメイン、ロゴ、ソーシャル URL。1 ページ目のみ返されます。

signal_group_totals
object[]

タイプ別のシグナル件数を、利用者のタイムゾーンの日単位で集計したもの。1 ページ目のみ返されます。

signal_type_totals
object[]

シグナルタイプ別の全期間合計件数。1 ページ目のみ返されます。

signal_type_recent_totals
object[]

直近 12 週間におけるシグナルタイプ別の合計件数。1 ページ目のみ返されます。

signal_weekly_totals
object[]

ヒートマップ用の週次シグナル件数。期間は signal_type_recent_totals と同じです。1 ページ目のみ返されます。

evidence_breakdown
object

返却された(秘匿処理済みの)シグナルから算出した、ソースタイプ別の証拠集計。1 ページ目のみ返されます。

presence
object

当該市場における企業の物理的・デジタル的なプレゼンスの観測結果。1 ページ目のみ返されます。

suppressions
object[]

ステージ計算から除外されたシグナルと、その理由。1 ページ目のみ返されます。

timeline
object[]

当該企業/市場ペアのステージ遷移履歴。1 ページ目のみ返されます。

other_markets
object[]

当該企業のその他のアクティブ市場。制限のあるプランでは上限が適用されます(other_markets_locked_count を参照)。1 ページ目のみ返されます。

other_markets_locked_count
integer

プランの制限により other_markets に含まれなかった市場の数。制限がない場合は 0

markets_summary
object[]

当該企業の完全な市場ランキングセット。markets_summary_fulltrue の場合に 1 ページ目でのみ返されます。