> ## 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 /people/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: /people/search: post: tags: - Search summary: 人物検索 description: 職種、所在地、企業、役職レベルなどの条件に一致する人物をPubrioデータベースから検索します。 operationId: people_search parameters: [] requestBody: required: true content: application/json: schema: type: object properties: search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' department_functions: $ref: '#/components/schemas/functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' company_locations: $ref: '#/components/schemas/company_locations' company_linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' linkedin_urls: $ref: '#/components/schemas/people_linkedin_urls' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' company_filters: $ref: '#/components/schemas/company_filters' filter_conditions: $ref: '#/components/schemas/people_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' query: type: string example: decision makers in marketing description: >- 自然言語検索。指定すると、Pubrio がそれを下記の人物および企業フィルター（職種、役職レベル、部門、地域、業界、企業規模など）に解釈します。同時に明示的に指定したフィルターは、解釈された値よりも優先されます。空にすると、構造化フィルターのみで検索します。 is_include_similar_people_titles: type: boolean description: >- 有効にすると、`people_titles` は完全一致だけでなく、類似する役職名（例：`software engineer` が `senior software engineer` に一致）も対象になります。 people_title_similarity_score: type: number format: float example: 0.9 description: >- `is_include_similar_people_titles` と併用します。役職名がどの程度一致する必要があるかを制御し、値が高いほど厳密に一致します。 profile_id: $ref: '#/components/schemas/profile_id' responses: '200': description: 関連する詳細情報を含む成功レスポンスです。 content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: metadata: filters: management_levels: - c_suite profile: null data: pagination: page: 1 per_page: 25 total_entries: 199616132 total_pages: 100 total_display_pages: 100 is_timeout: false peoples: - people_search_id: 134591fb-f0fa-41ba-9c8c-f1eb8aab8946 name: Doug McMillon first_name: Doug last_name: McMillon title: President & CEO seniority: c_suite functions: null headline: President & CEO at Walmart Inc. tagline: null introduction: null description: null departments: - c_suite subdepartments: - executive keywords: null employment_history: - title: President & CEO current: true end_date: null start_date: '2014-02-01' company_name: Walmart - title: President & CEO, Walmart International current: false end_date: '2014-01-01' start_date: '2009-02-01' company_name: Walmart - title: President & CEO current: false end_date: '2009-01-01' start_date: '2005-08-01' company_name: Sam's Club country: United States country_code: US location: United States state: Arkansas city: Bentonville wantedly_name: null rocketpunch_name: null contacts: null contact_types: [] emails: null phones: null facebook_url: null github_url: null twitter_url: null linkedin_url: http://www.linkedin.com/in/dougmcmillon wantedly_url: null rocketpunch_url: null saved_lists: null sequences: null social_metadata: {} company: company_name: Walmart company_url: http://walmart.com is_company_url_active: true domain: walmart.com domain_id: 26067151 domain_ids: - 757023267 - 368242703 - 26067151 domain_search_id: 2a0d6cd7-cc10-44d6-94ec-41fd528a11b6 founded_year: 1962 country: United States country_code: US location: United States phones: null emails: [] contacts: [] wantedly_name: null rocketpunch_name: null tiktok_name: null company_size_printed: 466,000 company_size: 466000 industry: Retail specialties: - Retail - E-commerce logo_url: >- https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg linkedin_url: http://www.linkedin.com/company/walmart facebook_url: http://facebook.com/walmart twitter_url: https://twitter.com/walmart crunchbase_url: null instagram_url: http://instagram.com/walmart youtube_url: http://youtube.com/user/walmart x_url: null github_url: null tiktok_url: null wantedly_url: null rocketpunch_url: null social_metadata: {} - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: search_term: type: string example: pubrio description: 検索結果を絞り込むために使用するキーワード文字列です。 people_name: type: string example: king description: 指定したユーザー名に一致する人物のみが含まれるように検索結果を絞り込みます。 people_titles: type: array items: type: string example: - sales manager - marketing manager description: >- 対象人物に関連する役職名です。完全一致でなくても、類似する役職を含む結果が返されます（例：`software engineer` で `senior software engineer` もヒット）。 peoples: type: array items: type: string format: uuid description: ユーザー検索処理で利用する `people_search_id` の一覧です。 management_levels: type: array items: type: string example: - head description: 現在の組織におけるマネジメントレベルを示します。C レベルやシニア層など、特定のレポート階層に属する人物を絞り込むために使用します。 departments: type: array items: type: string example: - master_human_resources description: 特定の専門領域に属する人物を探すための部署情報です。詳細はフィルタータブの `department` エンドポイントを参照します。 functions: type: array items: type: string example: - human_resources description: >- 職務機能フィルターで、検索対象の職種や専門分野を指定します。詳細はフィルタータブの `department functions` エンドポイントを参照します。 employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- 企業の従業員数レンジを表します。複数レンジを指定することで、対象となる会社規模の幅を広げられます。詳細は `company size` エンドポイントを参照します。 people_locations: type: array items: type: string example: - US - SG - CN description: ユーザー（人物）の所在地を示すフィルターです。 company_locations: type: array items: type: string example: - US - SG - CN description: 企業本社の所在地を示すフィルターです。 company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- 企業の LinkedIn 公式ページを指す完全な URL です。値は `http` で始まり、`linkedin.com/company/` を含んでいる必要があります。 people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- 個人の LinkedIn プロフィールを指す完全な URL です。値は `http` で始まり、`linkedin.com/in/` または `linkedin.com/pub/` を含んでいる必要があります。 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_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 people_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - places - exclude_places - social_media example: technologies description: >- 演算子を適用するフィルターキー。統一された企業フィルター名を参照します(`company_places` ではなく `places` を使用)。 operator: type: string enum: - or - and example: and description: 適用する論理演算子。指定された値のいずれかに一致するには 'or' を、すべてに一致するには 'and' を使用します。 description: >- /people/search におけるフィルターのキーごとの AND/OR 上書き。省略時のデフォルトは OR。完全なキー再マッピングのリファレンスは「人物 + 企業フィルター」開発者ガイドを参照してください。 is_enable_similarity_search: type: boolean description: >- 対応するフィルターで類似度検索を有効にするフラグです。有効化すると、ID ではなく自由テキストを渡しても、内部で類似スコアに基づいて候補を解決できます。 similarity_score: type: number format: float example: 0.7 description: >- `is_enable_similarity_search` と併用するスコアしきい値で、業種や技術などのスラッグとユーザー入力の近さを数値で指定します。値が高いほどマッチング条件が厳しくなり、より精度の高い結果に絞り込まれます。 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: エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。 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 ````