搜索职位发布
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": "服务器在处理请求时遇到了未预料的异常。"
}检索
公司职位检索
搜索符合指定条件（如地点、职位名称和发布日期）的公司职位发布。
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": "服务器在处理请求时遇到了未预料的异常。"
}请求体
application/json
ISO 3166-1 alpha-2（cca2）用于筛选地区。更多信息请参见筛选器标签下的 location 端点。
示例:
["US", "SG", "CN"]
从职位结果中排除的 ISO 3166-1 alpha-2 (cca2) 地区代码。有效代码请查看过滤器选项卡下的 location 端点。
示例:
["TW"]
公司总部所在地。更多信息请参见筛选器标签下的 location 端点。
示例:
["US", "SG", "CN"]
用于公司和人员检索操作的一组唯一标识符（domain_search_id）列表。
用于公司和人员检索操作的公司域名列表。如果收到的地址为 www.pubrio.com 或 https://docs.pubrio.com/，系统会自动转换为 pubrio.com 进行处理。
示例:
["pubrio.com"]
LinkedIn 公司主页的完整 URL。URL 需以 http 开头且包含 linkedin.com/company/。
示例:
["https://www.linkedin.com/company/pubrio"]
用于筛选结果的关键词字符串。
示例:
"pubrio"
用于过滤职位发布的关键词字符串数组。每个词与职位内容进行匹配。使用 search_term 传入单个字符串，或使用 search_terms 传入多个关键词。
示例:
["Software Developer"]
与目标人员相关的职位名称。
结果还将包含包含类似术语的职位，即使不完全匹配。例如，搜索 software engineer 也可能返回职位为 senior software engineer 的人员。
示例:
["sales manager", "marketing manager"]
发布日期的时间范围。最大值为当天。
示例:
["2025-01-01", "2025-01-10"]
为单一公司范围的查询（通过 domain_search_id、domains 或 linkedin_urls 过滤）启用实时数据增强。当初次搜索返回 0 条结果时，系统会抓取来源数据、写入记录后重新执行搜索再返回。受每条路由的超时限制约束。
示例:
true
每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。
示例:
25
要检索的数据页码。
示例:
1
可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。
更多信息请参见团队标签下的 user details 端点。
响应
包含相关详细信息的成功响应。
响应信息取决于具体接口。
⌘I