Skip to main content
POST
人物検索

承認

pubrio-api-key
string
header
必須

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

ボディ

application/json
search_term
string

検索結果を絞り込むために使用するキーワード文字列です。

例:

"pubrio"

people_name
string

指定したユーザー名に一致する人物のみが含まれるように検索結果を絞り込みます。

例:

"king"

people_titles
string[]

対象人物に関連する役職名です。完全一致でなくても、類似する役職を含む結果が返されます(例:software engineer で senior software engineer もヒット)。

例:
exclude_people_titles
string[]

除外する職種名です。people_titles と同じ単語単位のマッチングなので、["senior"] はその単語を含むすべての職種を除外します。people_titles の後に適用されます。

例:
peoples
string<uuid>[]

ユーザー検索処理で利用する people_search_id の一覧です。

management_levels
enum<string>[]

人物の報告階層。経営層のスラッグは c_level ではなく c_suite です。未知のスラッグはどの人物にも一致しません。全リストは Filters の management level エンドポイントから。

利用可能なオプション:
c_suite,
director,
entry,
founder,
head,
intern,
manager,
owner,
partner,
senior,
vp
例:
departments
string[]

特定の専門領域に属する人物を探すための部署情報です。詳細はフィルタータブの department エンドポイントを参照します。

例:
exclude_departments
string[]

除外する部門スラッグです。departments と同じ語彙です。部門が記録されていない人物は保持されます。

例:
department_functions
string[]

職務機能フィルターで、検索対象の職種や専門分野を指定します。詳細はフィルタータブの department functions エンドポイントを参照します。

例:
exclude_department_functions
string[]

除外する職能スラッグです。department_functions と同じ語彙です。職能が記録されていない人物は保持されます。

例:
employees
string[][]

企業の従業員数レンジを表します。複数レンジを指定することで、対象となる会社規模の幅を広げられます。詳細は company size エンドポイントを参照します。

例:
people_locations
string[]

ユーザー(人物)の所在地を示すフィルターです。

例:
exclude_people_locations
string[]

人物が居住していてはならない国(ISO 3166-1 alpha-2)です。people_locations と対になります。

例:
company_locations
string[]

企業本社の所在地を示すフィルターです。

例:
company_exclude_locations
string[]

除外する本社所在国(ISO 3166-1 alpha-2)です。company_locations と対になり、両方に同じコードを送ると何も返りません。

例:
company_linkedin_urls
string[]

企業の LinkedIn 公式ページを指す完全な URL です。値は http で始まり、linkedin.com/company/ を含んでいる必要があります。

例:
linkedin_urls
string[]

個人の LinkedIn プロフィールを指す完全な URL です。値は http で始まり、linkedin.com/in/ または linkedin.com/pub/ を含んでいる必要があります。

例:
companies
string<uuid>[]

企業および人物検索処理で利用する domain_search_id の一覧です。

domains
string[]

企業および人物検索に使用する会社ドメインの一覧です。www や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。

例:
company_filters
object

企業レベルフィルターのラッパーオブジェクト。推奨グループ化 — どのキーが人物を絞り(トップレベル)、どのキーが企業を絞るかを視覚的に分けます。トップレベルの企業フィルターと同じキーを受け付けます(例: 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 と同じ形状です。例はフィルター概要開発者ガイドを参照してください。

例:
filter_conditions
object[]

/people/search におけるフィルターのキーごとの AND/OR 上書き。省略時のデフォルトは OR。完全なキー再マッピングのリファレンスは「人物 + 企業フィルター」開発者ガイドを参照してください。

対応するフィルターで類似度検索を有効にするフラグです。有効化すると、ID ではなく自由テキストを渡しても、内部で類似スコアに基づいて候補を解決できます。

similarity_score
number<float>

is_enable_similarity_search と併用するスコアしきい値で、業種や技術などのスラッグとユーザー入力の近さを数値で指定します。値が高いほどマッチング条件が厳しくなり、より精度の高い結果に絞り込まれます。

例:

0.7

per_page
integer
デフォルト:25

1 ページあたりの件数。既定は 25 で、多くのプランではこれが上限でもあります。制限値はサブスクリプションの max_search_per_page で、Profile から取得できます。超過すると結果が丸められるのではなく、HTTP 416 とコード 41676(企業・人物検索では 41613)が返ります。

必須範囲: x <= 25
例:

25

page
integer
デフォルト:1

ページ番号(1 から開始)。上限はサブスクリプションの max_search_page(企業検索では max_company_search_page)で、Profile から取得できます。超過すると HTTP 416 が返ります。

例:

1

query
string

自然言語検索。指定すると、Pubrio がそれを下記の人物および企業フィルター(職種、役職レベル、部門、地域、業界、企業規模など)に解釈します。同時に明示的に指定したフィルターは、解釈された値よりも優先されます。空にすると、構造化フィルターのみで検索します。

例:

"decision makers in marketing"

is_include_similar_people_titles
boolean
デフォルト:true

既定で有効です。people_titles は各役職名に近い表記にも一致します(例:software engineer は senior software engineer に一致)。metadata.filters.people_titles は実際に検索された全リストを返します。

people_title_similarity_score
number<float>

is_include_similar_people_titles と併用します。役職名がどの程度一致する必要があるかを制御し、値が高いほど厳密に一致します。

例:

0.9

technologies
integer[]

特定のテクノロジーを利用している企業を検索するための tag_id 一覧です。ID はフィルタータブの technology エンドポイントから取得します。is_enable_similarity_search を有効化すると、["Shopify"] のような自由テキスト入力も可能になります。

テクノロジー一覧にある製品名は、その製品と同社の製品に一致します("Salesforce" は Salesforce Desk や Salesforce Service Cloud にも一致)。似た別製品には一致しません。それ以外のテキストは類似度で一致します。

categories
integer[]

特定のテクノロジーカテゴリを利用している企業を検索するための category_id 一覧です。is_enable_similarity_search を有効化すると、["CDN"] のような自由テキスト入力も可能になります。

verticals
integer[]

特定の業界・業種セグメントに属する企業を検索するための vertical_id 一覧です。is_enable_similarity_search を有効化すると、["AI"] などの自由テキスト入力が可能です。

vertical_categories
integer[]

特定の業界カテゴリに属する企業を検索するための vertical_category_id の一覧です。フィルターは is_enable_similarity_search に対応しており、有効化すると ["Information Technology"] のような自由テキストから候補 ID を解決できます。

vertical_sub_categories
integer[]

特定の業界サブカテゴリに属する企業を検索するための vertical_sub_category_id の一覧です。is_enable_similarity_search を有効化すると、["Software"] のような自由テキスト入力に基づいて関連 ID を検索できます。

keywords
string[]

会社を関連性、専門分野、または説明でフィルタリングするためのキーワードのリスト。

例:
founded_dates
integer[]

企業の設立年レンジです。最大値には当年が指定可能です。

例:
revenues
integer[]

企業収益の最小値と最大値を表すレンジです。

例:
company_places
string[]

結果をフィルタリングするための場所名(都市または地域)です。ローカライズまたは英語の場所名を受け付けます。

例:
company_exclude_places
string[]

結果から除外する場所名(都市または地域)です。ローカライズまたは英語の場所名を受け付けます。

例:

レスポンス

関連する詳細情報を含む成功レスポンスです。

metadata
object

リクエストのコンテキスト:エコーされた filters と parameters、任意の profile クレジット情報、ignored_fields(エンドポイントが破棄したボディキー)。

data
object | null

エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。

最終更新日 2025年12月8日