メインコンテンツへスキップ
POST
/
companies
/
jobs
/
search
求人検索
curl --request POST \
  --url https://api.pubrio.com/companies/jobs/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "locations": [
    "US",
    "SG",
    "CN"
  ],
  "exclude_locations": [
    "TW"
  ],
  "company_locations": [
    "US",
    "SG",
    "CN"
  ],
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "search_term": "pubrio",
  "search_terms": [
    "Software Developer"
  ],
  "titles": [
    "sales manager",
    "marketing manager"
  ],
  "posted_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "is_realtime_enrichment": true,
  "per_page": 25,
  "page": 1,
  "profile_id": 123
}
'
import requests

url = "https://api.pubrio.com/companies/jobs/search"

payload = {
    "locations": ["US", "SG", "CN"],
    "exclude_locations": ["TW"],
    "company_locations": ["US", "SG", "CN"],
    "companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "domains": ["pubrio.com"],
    "linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
    "search_term": "pubrio",
    "search_terms": ["Software Developer"],
    "titles": ["sales manager", "marketing manager"],
    "posted_dates": ["2025-01-01", "2025-01-10"],
    "is_realtime_enrichment": True,
    "per_page": 25,
    "page": 1,
    "profile_id": 123
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    locations: ['US', 'SG', 'CN'],
    exclude_locations: ['TW'],
    company_locations: ['US', 'SG', 'CN'],
    companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    domains: ['pubrio.com'],
    linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
    search_term: 'pubrio',
    search_terms: ['Software Developer'],
    titles: ['sales manager', 'marketing manager'],
    posted_dates: ['2025-01-01', '2025-01-10'],
    is_realtime_enrichment: true,
    per_page: 25,
    page: 1,
    profile_id: 123
  })
};

fetch('https://api.pubrio.com/companies/jobs/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pubrio.com/companies/jobs/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'locations' => [
        'US',
        'SG',
        'CN'
    ],
    'exclude_locations' => [
        'TW'
    ],
    'company_locations' => [
        'US',
        'SG',
        'CN'
    ],
    'companies' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'domains' => [
        'pubrio.com'
    ],
    'linkedin_urls' => [
        'https://www.linkedin.com/company/pubrio'
    ],
    'search_term' => 'pubrio',
    'search_terms' => [
        'Software Developer'
    ],
    'titles' => [
        'sales manager',
        'marketing manager'
    ],
    'posted_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'is_realtime_enrichment' => true,
    'per_page' => 25,
    'page' => 1,
    'profile_id' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pubrio.com/companies/jobs/search"

	payload := strings.NewReader("{\n  \"locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"exclude_locations\": [\n    \"TW\"\n  ],\n  \"company_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"companies\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"search_term\": \"pubrio\",\n  \"search_terms\": [\n    \"Software Developer\"\n  ],\n  \"titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"is_realtime_enrichment\": true,\n  \"per_page\": 25,\n  \"page\": 1,\n  \"profile_id\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("pubrio-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.pubrio.com/companies/jobs/search")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"exclude_locations\": [\n    \"TW\"\n  ],\n  \"company_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"companies\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"search_term\": \"pubrio\",\n  \"search_terms\": [\n    \"Software Developer\"\n  ],\n  \"titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"is_realtime_enrichment\": true,\n  \"per_page\": 25,\n  \"page\": 1,\n  \"profile_id\": 123\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/companies/jobs/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"exclude_locations\": [\n    \"TW\"\n  ],\n  \"company_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"companies\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"search_term\": \"pubrio\",\n  \"search_terms\": [\n    \"Software Developer\"\n  ],\n  \"titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"is_realtime_enrichment\": true,\n  \"per_page\": 25,\n  \"page\": 1,\n  \"profile_id\": 123\n}"

response = http.request(request)
puts response.read_body
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 2228628,
      "total_pages": 89146,
      "is_timeout": false
    },
    "jobs": [
      {
        "job_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848",
        "job_search_id": "371d0c44-4c56-4c9c-98e2-ef6dd986b848",
        "last_modified": "2025-05-31T20:41:27.894Z",
        "companies": {
          "logo_url": "https://buckets.pubrio.com/company-logo/OTQxMjYxMTFnb29nbGUuY29tLnBrbGlua2VkaW5fcF9sb2dvMTU=.jpg",
          "domain_search_id": "539e2c34-de6b-4613-8f5b-e3aa18b4ef47",
          "company_name": "Google",
          "linkedin_name": "google",
          "country_code": "US",
          "domain": "google.com"
        },
        "location": "Seoul, Seoul, South Korea",
        "job_url": "https://kr.linkedin.com/jobs/view/software-engineer-greach-program-for-people-with-disabilities-%EC%9E%A5%EC%95%A0%EC%9D%B8-%EC%B1%84%EC%9A%A9-at-google-4224659596?position=7&pageNum=0&refId=DwDpGXGftUql%2FkETvFCwXw%3D%3D&trackingId=gAvrIP0yUQuf8fjK67HSbQ%3D%3D",
        "posting_date": "2025-05-31",
        "country_code": "KR",
        "location_id": 491,
        "title": "Software Engineer, gReach Program for People with Disabilities (장애인 채용)",
        "country": "South Korea"
      },
      "..."
    ]
  }
}
{
  "code": 40001,
  "message": "エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。",
  "details": {}
}
{
  "error": "クライアントはしばらく待ってから再試行することが推奨されます。"
}
{
  "error": "レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。"
}

承認

​
pubrio-api-key
string
header
必須

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

ボディ

application/json
​
locations
string[]

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

例:
["US", "SG", "CN"]
​
exclude_locations
string[]

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

例:
["TW"]
​
company_locations
string[]

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

例:
["US", "SG", "CN"]
​
companies
string<uuid>[]

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

​
domains
string[]

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

例:
["pubrio.com"]
​
linkedin_urls
string[]

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

例:
["https://www.linkedin.com/company/pubrio"]
​
search_term
string

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

例:

"pubrio"

​
search_terms
string[]

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

例:
["Software Developer"]
​
titles
string[]

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

例:
["sales manager", "marketing manager"]
​
posted_dates
string[]

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

例:
["2025-01-01", "2025-01-10"]
​
is_realtime_enrichment
boolean
デフォルト:false

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

例:

true

​
per_page
integer

1 ページあたりに返される検索結果件数です。ページサイズを制限することで、レスポンス速度や API パフォーマンスの向上が期待できます。

例:

25

​
page
integer

取得したい結果セットのページ番号です。

例:

1

​
profile_id
integer

オプション。リクエストを送信するチームを表す識別子です。API キーにワークスペース情報が既に含まれているため、このパラメータは必須ではなくなりました。指定した場合、検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。

レスポンス

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

​
data
object | null

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