跳转到主要内容
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": "服务器在处理请求时遇到了未预料的异常。"
}

授权

​
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[]

公司总部所在地。更多信息请参见筛选器标签下的 location 端点。

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

用于公司和人员检索操作的一组唯一标识符（domain_search_id）列表。

​
domains
string[]

用于公司和人员检索操作的公司域名列表。如果收到的地址为 www.pubrio.com 或 https://docs.pubrio.com/，系统会自动转换为 pubrio.com 进行处理。

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

LinkedIn 公司主页的完整 URL。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

每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。

示例:

25

​
page
integer

要检索的数据页码。

示例:

1

​
profile_id
integer

可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。

更多信息请参见团队标签下的 user details 端点。

响应

包含相关详细信息的成功响应。

​
data
object | null

响应信息取决于具体接口。