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 エンドポイントを確認してください。

:
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 engineersenior software engineer もヒット)。

:
posted_dates
string[]

求人の掲載日レンジです。最大値には当日が指定可能です。

:
is_realtime_enrichment
boolean
デフォルト:false

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

:

true

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

リクエストのコンテキスト:エコーされた filters と、credittopup_credittotal_credit_cost を含む profile ブロック。

data
object | null

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