Skip to main content
POST
求人検索

承認

pubrio-api-key
string
header
必須

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

ボディ

application/json
locations
string[]

ISO 3166-1 alpha-2(CCA2)コードで地域を指定するフィルターです。詳細はフィルタータブの location エンドポイントを参照します。

例:
exclude_locations
string[]

求人結果から除外する ISO 3166-1 alpha-2 (cca2) 地域コードです。有効なコードはフィルタータブの location エンドポイントを確認してください。

例:
location_ids
integer[]

Pubrio の location_id による求人の国(Locations エンドポイント。各行にも含まれます)。locations の代替。

例:
company_locations
string[]

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

例:
companies
string<uuid>[]

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

domains
string[]

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

例:
linkedin_urls
string[]

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

例:
search_term
string

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

例:

"pubrio"

search_terms
string[]

求人投稿をフィルタリングするキーワード文字列の配列です。各キーワードは求人コンテンツと照合されます。単一の文字列には search_term、複数のキーワードには search_terms を使用してください。

例:
titles
string[]

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

例:
functions
string[]

職種名から導出した職能スラッグ(例:engineering、sales、marketing、finance、product_management)、または software_development などの部門職能スラッグ。大文字小文字は区別しません。未知のスラッグは何にも一致しません。全リストは列挙値と定数。

例:
departments
string[]

部門スラッグまたは名称(例:master_sales、Sales。大文字小文字は区別しません)。部門から取得します。職種名がいずれかの部門に該当する求人に一致し、カタログにない値は何にも一致しません。

例:
exclude_departments
string[]

除外する部門スラッグまたは名称。部門のない求人は残ります。

例:
seniority_ranks
enum<integer>[]

職種名から解決した職位ティア:1 ジュニア、2 シニア、3 マネージャー、4 ディレクター、5 エグゼクティブ。1–5 以外の値は何にも一致しません。各行は seniority_rank にティアを返します(0 = 未分類)。

利用可能なオプション:
1,
2,
3,
4,
5
例:
posted_dates
string[]

求人の掲載日レンジです。最大値には当日が指定可能です。 日付境界はワークスペースのタイムゾーンに従います。

例:
launch_dates
string<date>[]

公開日に対する両端含みの [from, to](UTC)。posting_date、なければ取り込み日を使います。求人インサイトの集計と一致します。日付 1 つならその 1 日に一致。

Required array length: 1 - 2 elements
例:
created_at
string<date-time>

この時刻以降に取り込まれたもの(UTC)。日付または ISO タイムスタンプ。増分同期では保存済み最新行の created_at を渡してください。

例:

"2026-09-02T12:00:00Z"

is_realtime_enrichment
boolean
デフォルト:false

単一企業スコープのクエリ(domain_search_id、domains、または linkedin_urls でフィルタリング)でリアルタイムエンリッチメントを有効化します。初回検索が 0 件の場合、エンドポイントはソースをスクレイプし、レコードを保存したうえで検索を再実行してから応答します。ルートごとのデッドラインの対象です。

例:

true

is_ascending_order
boolean
デフォルト:false

並び順です。デフォルトは新しい順で返され、true にすると古い順になります。このエンドポイントに sort_by はなく、ソートキーは固定でエンドポイントの説明に記載しています。

例:

false

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

レスポンス

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

metadata
object

リクエストのコンテキストです。

data
object
最終更新日 2025年12月8日