> ## 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. # 拡大検索 > 1 つ以上の市場に進出している企業を、企業属性・シグナルフィルターまたは自然言語クエリで検索します。各企業の実際のシグナルに基づく AI マッチ説明をオプションで生成できます。 ## OpenAPI ````yaml jp-openapi POST /expansions/search 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/search: post: tags: - Expansion summary: 拡大検索 description: >- 1 つ以上の市場に進出している企業を、企業属性・シグナルフィルターまたは自然言語クエリで検索します。各企業の実際のシグナルに基づく AI マッチ説明をオプションで生成できます。 operationId: expansions_search 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' min_markets: type: integer example: 3 description: 対象期間内に企業が参入した新規市場の最小数。 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-04-01' - '2026-06-29' description: >- タイムラインウィンドウ用の ISO 日付範囲です。デフォルトは直近 90 日間です。. A natural-language `query` may also set this from calendar phrases ("this year", "last year", "Q2 2026"). window_days: $ref: '#/components/schemas/window_days' query: type: string example: fintech companies expanding into the UK description: Pubrio が拡大および企業のフィルターに解釈する自然言語クエリ。 is_explain_match: type: boolean example: true description: >- 各企業が検索条件に一致する理由を、その企業の実際のシグナルに基づいて AI が生成した説明として付与します。自然言語クエリと併用するのが最適です。 引用されるシグナルの件数とバッチサイズはいずれも `per_page` に応じて変化します。求人情報や広告キャンペーンなど発生頻度の高いソースは、個別に列挙せず、期間内の件数としてまとめて表示されます（例：「12件の求人情報」）。 sort_by: $ref: '#/components/schemas/expansion_sort_by' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' profile_id: $ref: '#/components/schemas/profile_id' responses: '200': description: >- 対象市場で拡大している企業のページ分割リスト。`filters` は適用済み（または自然言語で解釈された）条件を反映し、`is_explain_match` が true の場合は各企業に `match_summary` が含まれます。 content: application/json: schema: type: object properties: metadata: type: object description: >- 検索メタデータ：実際に適用されたフィルタと、メタデータ要求時の市場ロールアップ（aggregate、地理スコープ、top origins/destinations/industries、timeline）。 properties: filters: type: object description: 実際に適用されたフィルタ（`query` 使用時は解釈済みの自然言語クエリを反映）。 relaxed_filters: type: array description: 自然言語クエリが何もマッチしなかった際に自動的に外されたソフトフィルタ。それ以外は null。 items: type: string aggregate: type: object description: 市場レベルのロールアップ。メタデータ要求時に含まれます。 country_code: type: string country_codes: type: array items: type: string direction: type: string is_global: type: boolean is_multi: type: boolean transitioned_dates: type: array items: type: string top_origins: type: array items: type: object top_destinations: type: array items: type: object top_industries: type: array items: type: object timeline: type: array items: type: object data: type: object description: 結果コンテナ（標準の検索エンベロープ）：企業リストとページネーション。 properties: pagination: type: object companies: type: array description: >- 企業リスト。各項目はネストされた `stage` を持ち、`is_explain_match` が true のとき `match_summary` を含みます。 items: type: object example: metadata: filters: tos: - GB verticals: - Financial Services data: pagination: page: 1 per_page: 25 total_entries: 87 total_pages: 4 total_display_pages: 4 is_timeout: false companies: - expansion_id: '6845525' domain_search_id: 550e8400-e29b-41d4-a716-446655440002 country_code: GB target_country_code: GB domain: example.com company_name: Example Corp home_country_code: CN industry: Consumer Electronics founded_year: 2015 employees_count: 320 stage: slug: expanding expansion_score: 0.72 scope: entering_new_market direction: advancing freshness: fresh signal_count: 27 presence: level: detected local_people_count: 12 has_known_office: true matched_rule: people read: code: ok 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` 範囲が指定されていない場合に使用されます。両方とも省略した場合はデフォルトのウィンドウが使用されます。 expansion_sort_by: type: string enum: - expansion_score - signal_count - company_ranking example: expansion_score description: >- 結果の並び順。省略した場合はデフォルト（直近の遷移が新しい順）が適用されます。`expansion_score` — 拡張スコアが高い順。`signal_count` — そのペアのシグナル数が多い順。`company_ranking` — Pubrio の総合企業ランキング順（数値が小さいほど知名度が高い）、昇順。 page: type: integer example: 1 description: 取得したい結果セットのページ番号です。 per_page: type: integer example: 25 description: 1 ページあたりに返される検索結果件数です。ページサイズを制限することで、レスポンス速度や API パフォーマンスの向上が期待できます。 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 ````