> ## 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.

# 企業検索

> 業種、規模、所在地、テクノロジーなどの条件に一致する企業をPubrioデータベースから検索します。



## OpenAPI

````yaml jp-openapi POST /companies/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:
  /companies/search:
    post:
      tags:
        - Search
      summary: 企業検索
      description: 業種、規模、所在地、テクノロジーなどの条件に一致する企業をPubrioデータベースから検索します。
      operationId: companies_search
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                company_name:
                  $ref: '#/components/schemas/company_name'
                companies:
                  $ref: '#/components/schemas/companies'
                domains:
                  $ref: '#/components/schemas/domains'
                linkedin_urls:
                  $ref: '#/components/schemas/company_linkedin_urls'
                company_filters:
                  $ref: '#/components/schemas/company_filters'
                locations:
                  $ref: '#/components/schemas/locations'
                exclude_locations:
                  $ref: '#/components/schemas/exclude_locations'
                places:
                  $ref: '#/components/schemas/places'
                exclude_places:
                  $ref: '#/components/schemas/exclude_places'
                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'
                verticals:
                  $ref: '#/components/schemas/verticals'
                vertical_categories:
                  $ref: '#/components/schemas/vertical_categories'
                vertical_sub_categories:
                  $ref: '#/components/schemas/vertical_sub_categories'
                categories:
                  $ref: '#/components/schemas/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'
                news_categories:
                  $ref: '#/components/schemas/news_categories'
                news_published_dates:
                  $ref: '#/components/schemas/published_dates'
                advertisement_search_terms:
                  $ref: '#/components/schemas/advertisement_search_terms'
                advertisement_target_locations:
                  $ref: '#/components/schemas/advertisement_target_locations'
                advertisement_exclude_target_locations:
                  $ref: '#/components/schemas/advertisement_exclude_target_locations'
                advertisement_start_dates:
                  $ref: '#/components/schemas/advertisement_start_dates'
                advertisement_end_dates:
                  $ref: '#/components/schemas/advertisement_end_dates'
                filter_conditions:
                  $ref: '#/components/schemas/company_filter_conditions'
                is_enable_similarity_search:
                  $ref: '#/components/schemas/is_enable_similarity_search'
                similarity_score:
                  $ref: '#/components/schemas/similarity_score'
                exclude_fields:
                  $ref: '#/components/schemas/exclude_fields'
                is_parameter_metadata_available:
                  $ref: '#/components/schemas/is_parameter_metadata_available'
                is_profile_metadata_available:
                  $ref: '#/components/schemas/is_profile_metadata_available'
                per_page:
                  $ref: '#/components/schemas/per_page'
                page:
                  $ref: '#/components/schemas/page'
                profile_id:
                  $ref: '#/components/schemas/profile_id'
      responses:
        '200':
          description: 関連する詳細情報を含む成功レスポンスです。
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/data'
              example:
                data:
                  pagination:
                    page: 1
                    per_page: 25
                    total_entries: 45234700
                    total_pages: 1809388
                  companies:
                    - logo_url: >-
                        https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg
                      company_name: Twitter
                      emails:
                        - ...
                      phones:
                        - ...
                      contacts:
                        - ...
                      founded_year: 2006
                      specialties:
                        - Software Development
                      industry: Software Development
                      domain: twitter.com
                      domain_search_id: 61a73da7-2efc-41a5-a252-a8a8df29925a
                      domain_id: 224475931
                      linkedin_company_id: 44005587
                      linkedin_name: twitter
                      is_company_url_active: true
                      domain_ids:
                        - 224475931
                        - 1758889566
                        - 368242865
                      company_keywords:
                        - realtime information
                        - social commerce
                        - online shopping
                        - classifieds
                        - craigslist killers
                        - e-commerce
                        - killers
                        - consumer internet
                        - internet
                        - information technology
                        - edp services
                        - technology
                        - software development
                        - microblogging
                        - social networking
                        - public conversation
                        - user engagement
                        - content sharing
                        - advertising solutions
                        - monetization
                        - community building
                        - digital wallet
                        - ai integration
                        - user safety
                      company_size: 1500
                      youtube_url: null
                      crunchbase_url: null
                      linkedin_url: http://www.linkedin.com/company/twitter
                      instagram_url: null
                      facebook_url: http://facebook.com/twitterinc
                      twitter_url: https://twitter.com/x
                      github_url: null
                      x_url: null
                      location: United States
                      company_ranking: null
                      company_url: http://twitter.com
                      saved_lists: null
                      company_size_printed: 1,500
                    - ...
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    company_name:
      type: string
      example: pubrio
      description: >-
        検索結果を、指定した社名に一致する企業のみに絞り込むためのフィルターです。入力値が企業名と一致しない場合、その企業は他の条件を満たしていても結果に含まれず、部分一致によるマッチングもサポートされます。
    companies:
      type: array
      items:
        type: string
        format: uuid
      description: 企業および人物検索処理で利用する `domain_search_id` の一覧です。
    domains:
      type: array
      items:
        type: string
      example:
        - pubrio.com
      description: 企業および人物検索に使用する会社ドメインの一覧です。`www` や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。
    company_linkedin_urls:
      type: array
      items:
        type: string
      example:
        - https://www.linkedin.com/company/pubrio
      description: >-
        企業の LinkedIn 公式ページを指す完全な URL です。値は `http` で始まり、`linkedin.com/company/`
        を含んでいる必要があります。
    company_filters:
      type: object
      description: >-
        企業レベルフィルターのラッパーオブジェクト。推奨グループ化 —
        どのキーが*人物*を絞り(トップレベル)、どのキーが*企業*を絞るかを視覚的に分けます。トップレベルの企業フィルターと同じキーを受け付けます(例:
        `technologies`、`verticals`、`vertical_categories`、`vertical_sub_categories`、`categories`、`keywords`、`founded_dates`、`employees`、`revenues`、`company_locations`、`company_exclude_locations`、`company_places`、`company_exclude_places`、`companies`、`domains`、`company_linkedin_urls`、`is_enable_similarity_search`、`similarity_score`、および
        `filter_conditions`)。エンジンは処理前にこのオブジェクトをトップレベルに展開します —
        同名キーがある場合はトップレベルが勝ちます。Monitor `company_filters`
        と同じ形状です。例はフィルター概要開発者ガイドを参照してください。
      example:
        company_locations:
          - US
        technologies:
          - 37
          - 152
        founded_dates:
          - 2015
          - 2023
        filter_conditions:
          - key: technologies
            operator: and
    locations:
      type: array
      items:
        type: string
      example:
        - US
        - SG
        - CN
      description: >-
        ISO 3166-1 alpha-2（CCA2）コードで地域を指定するフィルターです。詳細はフィルタータブの `location`
        エンドポイントを参照します。
    exclude_locations:
      type: array
      items:
        type: string
      example:
        - CN
        - US
        - RU
        - CA
      description: ISO 3166-1 alpha-2 コードで、検索結果から除外する地域を指定します。
    places:
      type: array
      items:
        type: string
      example:
        - Tokyo
      description: 結果をフィルタリングするための場所名（都市または地域）です。ローカライズまたは英語の場所名を受け付けます。
    exclude_places:
      type: array
      items:
        type: string
      example:
        - Tokyo
      description: 結果から除外する場所名（都市または地域）です。ローカライズまたは英語の場所名を受け付けます。
    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` もヒット）。
    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 を検索できます。
    categories:
      type: array
      items:
        type: integer
      description: >-
        特定のテクノロジーカテゴリを利用している企業を検索するための `category_id`
        一覧です。`is_enable_similarity_search` を有効化すると、`["CDN"]`
        のような自由テキスト入力も可能になります。
    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: 会社を関連性、専門分野、または説明でフィルタリングするためのキーワードのリスト。
    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: ニュースの公開日レンジです。最大値には当日が指定可能です。
    advertisement_search_terms:
      type: array
      items:
        type: string
      example:
        - asus
      description: 広告コンテンツやタイトル内で検索するために使用するキーワードです。
    advertisement_target_locations:
      $ref: '#/components/schemas/target_locations'
      description: 広告のターゲット地理的位置。
    advertisement_exclude_target_locations:
      $ref: '#/components/schemas/exclude_target_locations'
      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: 広告フィルタリングの終了日範囲です。
    company_filter_conditions:
      type: array
      items:
        type: object
        properties:
          key:
            type: string
            enum:
              - keywords
              - verticals
              - vertical_categories
              - vertical_sub_categories
              - technologies
              - categories
              - advertisement_target_locations
              - advertisement_exclude_target_locations
              - advertisement_search_terms
              - places
              - exclude_places
              - job_exclude_locations
            example: keywords
            description: 適用する演算子のフィルターキーを指定します。
          operator:
            type: string
            enum:
              - or
              - and
            example: or
            description: 適用する論理演算子。指定された値のいずれかに一致するには 'or' を、すべてに一致するには 'and' を使用します。
      description: 企業検索の高度なフィルタリングオプションです。キーと論理演算子を組み合わせた条件を指定して検索結果を絞り込めます。
    is_enable_similarity_search:
      type: boolean
      description: >-
        対応するフィルターで類似度検索を有効にするフラグです。有効化すると、ID
        ではなく自由テキストを渡しても、内部で類似スコアに基づいて候補を解決できます。
    similarity_score:
      type: number
      format: float
      example: 0.7
      description: >-
        `is_enable_similarity_search`
        と併用するスコアしきい値で、業種や技術などのスラッグとユーザー入力の近さを数値で指定します。値が高いほどマッチング条件が厳しくなり、より精度の高い結果に絞り込まれます。
    exclude_fields:
      type: array
      items:
        type: string
      example:
        - emails
        - phones
        - contacts
      description: レスポンスペイロードから除外するフィールドのリストです。
    is_parameter_metadata_available:
      type: boolean
      description: リクエストにパラメータメタデータが利用可能かどうかを示します。
    is_profile_metadata_available:
      type: boolean
      description: リクエストにプロファイルメタデータが利用可能かどうかを示します。
    per_page:
      type: integer
      example: 25
      description: 1 ページあたりに返される検索結果件数です。ページサイズを制限することで、レスポンス速度や API パフォーマンスの向上が期待できます。
    page:
      type: integer
      example: 1
      description: 取得したい結果セットのページ番号です。
    profile_id:
      type: integer
      description: >-
        オプション。リクエストを送信するチームを表す識別子です。API
        キーにワークスペース情報が既に含まれているため、このパラメータは必須ではなくなりました。指定した場合、検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。
    data:
      type: object
      nullable: true
      description: エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。
    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' とともに指定された場合、広告は除外された場所のどれもターゲットにしていない必要があります。
  responses:
    general_error:
      description: リクエストエラー。リクエストの形式が不正であるか、無効なパラメータが含まれています。エラーコードとメッセージを確認してください。
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。
                type: string
              details:
                type: object
    rate_limit_error:
      description: レート制限超過。一定期間内に多すぎるリクエストが送信されました。レート制限ウィンドウがリセットされた後に再試行してください。
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: クライアントはしばらく待ってから再試行することが推奨されます。
                type: string
    server_error:
      description: 内部サーバーエラー。サーバーで予期しないエラーが発生しました。エラーが続く場合はサポートにお問い合わせください。
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの
        [設定](https://dashboard.pubrio.com/#/settings/) 画面から発行できます。
      in: header

````