> ## 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. # 拡大の概要 > 市場レベルのエクスパンション KPI——市場別のステージ件数と主要な越境フロー。集計済みで、ページ分割はありません。 ## OpenAPI ````yaml jp-openapi POST /expansions/dashboard openapi: 3.0.0 info: description: >- Pubrio API はマーケット拡大インテリジェンスを提供します——企業の新市場参入を捉えるリアルタイムシグナルと、その基盤となる企業・人物データ。アカウントやコンタクトの検索・ルックアップ・エンリッチメントに加え、200+ 市場にわたる種別・日付付きの動きシグナルを購読できます。 version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ja/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ja/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: ワークスペースプロフィール情報と使用統計 - name: Enrichment description: 詳細なB2Bデータで人物・企業レコードをエンリッチメント - name: Lookalike description: 指定した企業に類似する企業を検索 - name: Search description: フィルターを使用して人物、企業、求人、ニュース、広告を検索 - name: Lookup description: 特定の人物、企業、求人、ニュース、広告、テクノロジーの詳細情報を検索 - name: LinkedIn description: LinkedInプロフィールURLから人物・企業データを検索 - name: Redeem description: クレジットを消費して人物の連絡先情報をアンロック（単件・バッチ） - name: Channels description: アウトリーチチャネルテンプレートの管理（作成・更新・削除・一覧） - name: Monitor description: Webhook、統計、処理を含むデータモニターの作成と管理 - name: Filters description: 検索パラメータで使用可能なフィルター値を取得（テクノロジー、地域、バーティカルなど） - name: API Keys description: APIキーのリクエストログと使用状況分析を表示 - name: Insights description: 企業のシグナル集計インサイト(採用、ニュース、広告)。 - name: Export description: 一括データエクスポート(クレジット消費)。 - name: Expansion description: '企業の市場拡大インテリジェンス: シグナル、ステージ、市場、エクスポート。' externalDocs: description: >- Pubrio API は、コンタクトおよびアカウント情報の検索・プレビュー・エンリッチメントに利用できます。Pubrio データベースは、豊富な B2B 連絡先データとセールスインテリジェンスを提供します。 url: https://docs.pubrio.com paths: /expansions/dashboard: post: tags: - Expansion summary: 拡大の概要 description: 市場レベルのエクスパンション KPI——市場別のステージ件数と主要な越境フロー。集計済みで、ページ分割はありません。 operationId: expansions_dashboard requestBody: required: true content: application/json: schema: type: object properties: froms: $ref: '#/components/schemas/expansion_froms' tos: $ref: '#/components/schemas/expansion_tos' exclude_froms: $ref: '#/components/schemas/expansion_exclude_froms' exclude_tos: $ref: '#/components/schemas/expansion_exclude_tos' stages: $ref: '#/components/schemas/expansion_stages' momentum: $ref: '#/components/schemas/expansion_momentum' freshness: $ref: '#/components/schemas/expansion_freshness' scopes: $ref: '#/components/schemas/expansion_scopes' ahead_of_pace: type: boolean example: false description: その市場の標準的なペースより速く動いている企業/市場のペアに限定します。 signal_types: $ref: '#/components/schemas/expansion_signal_type_slugs' signal_strengths: $ref: '#/components/schemas/signal_strengths' min_signal_count: type: integer example: 3 description: その期間内で企業が持つべき拡大シグナルの最小件数です — 「非常に活発 / 展開の広い」企業を絞り込みます。 only_contraction: $ref: '#/components/schemas/only_contraction' verticals: $ref: '#/components/schemas/verticals' vertical_categories: $ref: '#/components/schemas/vertical_categories' vertical_sub_categories: $ref: '#/components/schemas/vertical_sub_categories' technologies: $ref: '#/components/schemas/technologies' employees: $ref: '#/components/schemas/employees' revenues: $ref: '#/components/schemas/revenues' founded_dates: $ref: '#/components/schemas/founded_dates' keywords: $ref: '#/components/schemas/keywords' companies: $ref: '#/components/schemas/expansion_companies' job_locations: $ref: '#/components/schemas/locations' job_exclude_locations: $ref: '#/components/schemas/job_exclude_locations' job_posted_dates: $ref: '#/components/schemas/posted_dates' job_titles: $ref: '#/components/schemas/people_titles' advertisement_target_locations: $ref: '#/components/schemas/advertisement_target_locations' advertisement_exclude_target_locations: $ref: '#/components/schemas/advertisement_exclude_target_locations' advertisement_search_terms: $ref: '#/components/schemas/advertisement_search_terms' advertisement_start_dates: $ref: '#/components/schemas/advertisement_start_dates' advertisement_end_dates: $ref: '#/components/schemas/advertisement_end_dates' news_categories: $ref: '#/components/schemas/news_categories' news_published_dates: $ref: '#/components/schemas/published_dates' transitioned_dates: type: array items: type: string format: date example: - '2026-06-01' - '2026-06-29' description: ウォッチリストのタイムライン用 ISO 日付範囲 [start, end] です。デフォルトは直近 30 日間です。 window_days: $ref: '#/components/schemas/window_days' select_size: type: integer example: 250 description: 返却する市場数の上限です(プランによる上限あり)。 flows_size: type: integer example: 50 description: 返却するクロスボーダーフロー数の上限です(プランによる上限あり)。 profile_id: $ref: '#/components/schemas/profile_id' responses: '200': description: 市場ダッシュボードの集計データです。 content: application/json: schema: type: object properties: metadata: type: object data: type: object description: 'ダッシュボードのコンテナ: ランク付けされた市場と、主要なコリドーフローです。' properties: countries: type: array description: 市場ごとのシグナル件数を伴う、ランク付けされた市場です。 items: type: object top_flows: type: array items: type: object example: metadata: filters: froms: - CN tos: - GB select_size: 250 flows_size: 50 transitioned_dates: - '2026-06-01' - '2026-06-29' data: countries: - country_code: US inbound_count: 18 outbound_count: 5 total_companies_with_signals: 23 exploring_count: 8 committing_count: 10 expanding_count: 4 scaling_count: 1 new_transitions_30d: 3 freshest_transition_at: '2026-06-27T14:32:10.000Z' top_flows: - home_country_code: SG country_code: US company_count: 5 new_transitions_30d: 1 components: schemas: expansion_froms: type: array items: type: string example: - US - GB description: >- 出発市場（ISO 3166-1 alpha-2）。企業がどの市場から拡大しているか —— 本社 / 母国。単独で使うとこれらの市場から外へ拡大する企業を検索でき、`tos` と組み合わせると特定の 出発→到達 コリドーを指定できます。 expansion_tos: type: array items: type: string example: - US - GB description: >- 到達市場（ISO 3166-1 alpha-2）。企業がどの市場へ拡大しているか。単独で使うとこれらの市場に参入するすべての企業を検索でき、`froms` と組み合わせると特定の 出発→到達 コリドーを指定できます。 expansion_exclude_froms: type: array items: type: string example: - US - GB description: 除外する出発市場（ISO 3166-1 alpha-2）。 expansion_exclude_tos: type: array items: type: string example: - US - GB description: 除外する到達市場（ISO 3166-1 alpha-2）。 expansion_stages: type: array items: type: string enum: - exploring - committing - expanding - scaling - established example: - committing - expanding description: 1 つ以上のエクスパンションステージに絞り込みます。ステージの定義は Expansion Signals ナレッジベースを参照してください。 expansion_momentum: type: array items: type: string enum: - accelerating - advancing - steady - pulling_back example: - accelerating - advancing description: >- エクスパンションモメンタム(ステージ間の推移軌跡)で絞り込みます: `accelerating`(モード変化を伴う前進の加速)、`advancing`(前進)、`steady`(横ばい)、`pulling_back`(後退・縮小)。 expansion_freshness: type: array items: type: string enum: - fresh - cooling - stale - cold example: - fresh - cooling description: >- 証拠の新しさでフィルタします：fresh（約 30 日）、cooling（約 30〜60 日）、stale（約 60〜90 日）、cold（90 日超）。 expansion_scopes: type: array items: type: string enum: - entering_new_market - expanding_within_presence - established_only example: - entering_new_market description: 市場参入のスコープでフィルタします。 expansion_signal_type_slugs: type: array items: type: string enum: - AD - NEWS - INFRA - PARTNER - EVENT_PLUS - EXEC - OFFICE - HIRE - SCALE - PRODUCT example: - EXEC - HIRE description: 特定のシグナルの種類に絞り込みます。 signal_strengths: type: array items: type: string enum: - low - medium - high - very_high example: - high - very_high description: シグナル強度の区分で絞り込みます。 only_contraction: type: boolean example: false description: true の場合、縮小フラグの付いた拡大のみを返します（規模を縮小している企業）。 verticals: type: array items: type: integer description: >- 特定の業界・業種セグメントに属する企業を検索するための `vertical_id` 一覧です。`is_enable_similarity_search` を有効化すると、`["AI"]` などの自由テキスト入力が可能です。 vertical_categories: type: array items: type: integer description: >- 特定の業界カテゴリに属する企業を検索するための `vertical_category_id` の一覧です。フィルターは `is_enable_similarity_search` に対応しており、有効化すると `["Information Technology"]` のような自由テキストから候補 ID を解決できます。 vertical_sub_categories: type: array items: type: integer description: >- 特定の業界サブカテゴリに属する企業を検索するための `vertical_sub_category_id` の一覧です。`is_enable_similarity_search` を有効化すると、`["Software"]` のような自由テキスト入力に基づいて関連 ID を検索できます。 technologies: type: array items: type: integer description: >- 特定のテクノロジーを利用している企業を検索するための `tag_id` 一覧です。ID はフィルタータブの `technology` エンドポイントから取得します。`is_enable_similarity_search` を有効化すると、`["Shopify"]` のような自由テキスト入力も可能になります。 employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- 企業の従業員数レンジを表します。複数レンジを指定することで、対象となる会社規模の幅を広げられます。詳細は `company size` エンドポイントを参照します。 revenues: type: array items: type: integer example: - 0 - 100000 description: 企業収益の最小値と最大値を表すレンジです。 founded_dates: type: array items: type: integer example: - 2018 - 2024 description: 企業の設立年レンジです。最大値には当年が指定可能です。 keywords: type: array items: type: string example: - ecommerce - ai - fintech description: 会社を関連性、専門分野、または説明でフィルタリングするためのキーワードのリスト。 expansion_companies: type: array items: type: string example: - stripe.com - https://www.linkedin.com/company/airbnb - 550e8400-e29b-41d4-a716-446655440000 description: >- `domain_search_id`、会社ドメイン、または会社のソーシャルメディアプロフィール URL の任意の組み合わせで企業を指定します。ドメインと URL は最も上位の企業に解決されます。 locations: type: array items: type: string example: - US - SG - CN description: >- ISO 3166-1 alpha-2（CCA2）コードで地域を指定するフィルターです。詳細はフィルタータブの `location` エンドポイントを参照します。 job_exclude_locations: $ref: '#/components/schemas/exclude_locations' description: 求人結果から除外する地理的位置。 posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: 求人の掲載日レンジです。最大値には当日が指定可能です。 people_titles: type: array items: type: string example: - sales manager - marketing manager description: >- 対象人物に関連する役職名です。完全一致でなくても、類似する役職を含む結果が返されます（例：`software engineer` で `senior software engineer` もヒット）。 advertisement_target_locations: $ref: '#/components/schemas/target_locations' description: 広告のターゲット地理的位置。 advertisement_exclude_target_locations: $ref: '#/components/schemas/exclude_target_locations' description: 広告ターゲティングから除外する地理的位置。 advertisement_search_terms: type: array items: type: string example: - asus description: 広告コンテンツやタイトル内で検索するために使用するキーワードです。 advertisement_start_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: 広告フィルタリングの開始日範囲です。 advertisement_end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: 広告フィルタリングの終了日範囲です。 news_categories: type: array items: type: string example: - launches description: 特定のニュースカテゴリを検索するためのカテゴリスラッグ一覧です。スラッグは `news categories` エンドポイントから取得します。 published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: ニュースの公開日レンジです。最大値には当日が指定可能です。 window_days: type: integer example: 90 description: >- 任意。ローリングウィンドウの日数。明示的な `transitioned_dates` 範囲が指定されていない場合に使用されます。両方とも省略した場合はデフォルトのウィンドウが使用されます。 profile_id: type: integer description: >- オプション。リクエストを送信するチームを表す識別子です。API キーにワークスペース情報が既に含まれているため、このパラメータは必須ではなくなりました。指定した場合、検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。 exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: ISO 3166-1 alpha-2 コードで、検索結果から除外する地域を指定します。 target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- 国コードで特定の場所をターゲットにしている広告をフィルタリングします。特定の国で表示されている広告を検索します。`filter_conditions` と OR 演算子で組み合わせて使用します - 広告は指定された場所のうち少なくとも 1 つをターゲットにしている必要があります。 exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- 国コードで特定の場所をターゲットにしている広告を除外します。特定の国で表示されている広告をフィルタリング除外します。`filter_conditions` で演算子 'or' とともに指定された場合、広告は除外された場所のどれもターゲットにしていない必要があります。 securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの [設定](https://dashboard.pubrio.com/#/settings/) 画面から発行できます。 in: header ````