公司职位检索 - Pubrio Documentation

搜索职位发布

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"
  ],
  "location_ids": [
    357,
    419
  ],
  "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"
  ],
  "functions": [
    "engineering",
    "product_management"
  ],
  "departments": [
    "master_sales"
  ],
  "exclude_departments": [
    "c_suite"
  ],
  "seniority_ranks": [
    4,
    5
  ],
  "posted_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "launch_dates": [
    "2026-08-01",
    "2026-08-31"
  ],
  "created_at": "2026-09-02T12:00:00Z",
  "is_realtime_enrichment": true,
  "is_ascending_order": false,
  "per_page": 25,
  "page": 1
}
'

import requests

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

payload = {
    "locations": ["US", "SG", "CN"],
    "exclude_locations": ["TW"],
    "location_ids": [357, 419],
    "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"],
    "functions": ["engineering", "product_management"],
    "departments": ["master_sales"],
    "exclude_departments": ["c_suite"],
    "seniority_ranks": [4, 5],
    "posted_dates": ["2025-01-01", "2025-01-10"],
    "launch_dates": ["2026-08-01", "2026-08-31"],
    "created_at": "2026-09-02T12:00:00Z",
    "is_realtime_enrichment": True,
    "is_ascending_order": False,
    "per_page": 25,
    "page": 1
}
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'],
    location_ids: [357, 419],
    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'],
    functions: ['engineering', 'product_management'],
    departments: ['master_sales'],
    exclude_departments: ['c_suite'],
    seniority_ranks: [4, 5],
    posted_dates: ['2025-01-01', '2025-01-10'],
    launch_dates: ['2026-08-01', '2026-08-31'],
    created_at: '2026-09-02T12:00:00Z',
    is_realtime_enrichment: true,
    is_ascending_order: false,
    per_page: 25,
    page: 1
  })
};

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'
    ],
    'location_ids' => [
        357,
        419
    ],
    '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'
    ],
    'functions' => [
        'engineering',
        'product_management'
    ],
    'departments' => [
        'master_sales'
    ],
    'exclude_departments' => [
        'c_suite'
    ],
    'seniority_ranks' => [
        4,
        5
    ],
    'posted_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'launch_dates' => [
        '2026-08-01',
        '2026-08-31'
    ],
    'created_at' => '2026-09-02T12:00:00Z',
    'is_realtime_enrichment' => true,
    'is_ascending_order' => false,
    'per_page' => 25,
    'page' => 1
  ]),
  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  \"location_ids\": [\n    357,\n    419\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  \"functions\": [\n    \"engineering\",\n    \"product_management\"\n  ],\n  \"departments\": [\n    \"master_sales\"\n  ],\n  \"exclude_departments\": [\n    \"c_suite\"\n  ],\n  \"seniority_ranks\": [\n    4,\n    5\n  ],\n  \"posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"launch_dates\": [\n    \"2026-08-01\",\n    \"2026-08-31\"\n  ],\n  \"created_at\": \"2026-09-02T12:00:00Z\",\n  \"is_realtime_enrichment\": true,\n  \"is_ascending_order\": false,\n  \"per_page\": 25,\n  \"page\": 1\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  \"location_ids\": [\n    357,\n    419\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  \"functions\": [\n    \"engineering\",\n    \"product_management\"\n  ],\n  \"departments\": [\n    \"master_sales\"\n  ],\n  \"exclude_departments\": [\n    \"c_suite\"\n  ],\n  \"seniority_ranks\": [\n    4,\n    5\n  ],\n  \"posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"launch_dates\": [\n    \"2026-08-01\",\n    \"2026-08-31\"\n  ],\n  \"created_at\": \"2026-09-02T12:00:00Z\",\n  \"is_realtime_enrichment\": true,\n  \"is_ascending_order\": false,\n  \"per_page\": 25,\n  \"page\": 1\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  \"location_ids\": [\n    357,\n    419\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  \"functions\": [\n    \"engineering\",\n    \"product_management\"\n  ],\n  \"departments\": [\n    \"master_sales\"\n  ],\n  \"exclude_departments\": [\n    \"c_suite\"\n  ],\n  \"seniority_ranks\": [\n    4,\n    5\n  ],\n  \"posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"launch_dates\": [\n    \"2026-08-01\",\n    \"2026-08-31\"\n  ],\n  \"created_at\": \"2026-09-02T12:00:00Z\",\n  \"is_realtime_enrichment\": true,\n  \"is_ascending_order\": false,\n  \"per_page\": 25,\n  \"page\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "metadata": {
    "profile": null,
    "filters": {
      "domains": [
        "google.com"
      ],
      "per_page": 25,
      "language": "en"
    },
    "ignored_fields": []
  },
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 2228628,
      "total_pages": 89146,
      "is_timeout": false,
      "total_display_pages": 250
    },
    "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",
        "created_at": "2025-05-10T14:30:58.348Z",
        "source_type": "linkedin",
        "functions": null,
        "seniority_rank": 0,
        "base_salary": null,
        "experience_requirement": null,
        "education_requirement": null,
        "employment_type": null
      },
      "..."
    ]
  }
}

{
  "code": 40001,
  "message": "错误及代码会根据不同场景有所不同，详情请参阅文档。",
  "details": {}
}

{
  "error": "请求频率超出限制。请稍后再试。"
}

{
  "error": "服务器在处理请求时遇到了未预料的异常。"
}

POST

companies

jobs

搜索职位发布

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"
  ],
  "location_ids": [
    357,
    419
  ],
  "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"
  ],
  "functions": [
    "engineering",
    "product_management"
  ],
  "departments": [
    "master_sales"
  ],
  "exclude_departments": [
    "c_suite"
  ],
  "seniority_ranks": [
    4,
    5
  ],
  "posted_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "launch_dates": [
    "2026-08-01",
    "2026-08-31"
  ],
  "created_at": "2026-09-02T12:00:00Z",
  "is_realtime_enrichment": true,
  "is_ascending_order": false,
  "per_page": 25,
  "page": 1
}
'

import requests

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

payload = {
    "locations": ["US", "SG", "CN"],
    "exclude_locations": ["TW"],
    "location_ids": [357, 419],
    "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"],
    "functions": ["engineering", "product_management"],
    "departments": ["master_sales"],
    "exclude_departments": ["c_suite"],
    "seniority_ranks": [4, 5],
    "posted_dates": ["2025-01-01", "2025-01-10"],
    "launch_dates": ["2026-08-01", "2026-08-31"],
    "created_at": "2026-09-02T12:00:00Z",
    "is_realtime_enrichment": True,
    "is_ascending_order": False,
    "per_page": 25,
    "page": 1
}
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'],
    location_ids: [357, 419],
    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'],
    functions: ['engineering', 'product_management'],
    departments: ['master_sales'],
    exclude_departments: ['c_suite'],
    seniority_ranks: [4, 5],
    posted_dates: ['2025-01-01', '2025-01-10'],
    launch_dates: ['2026-08-01', '2026-08-31'],
    created_at: '2026-09-02T12:00:00Z',
    is_realtime_enrichment: true,
    is_ascending_order: false,
    per_page: 25,
    page: 1
  })
};

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'
    ],
    'location_ids' => [
        357,
        419
    ],
    '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'
    ],
    'functions' => [
        'engineering',
        'product_management'
    ],
    'departments' => [
        'master_sales'
    ],
    'exclude_departments' => [
        'c_suite'
    ],
    'seniority_ranks' => [
        4,
        5
    ],
    'posted_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'launch_dates' => [
        '2026-08-01',
        '2026-08-31'
    ],
    'created_at' => '2026-09-02T12:00:00Z',
    'is_realtime_enrichment' => true,
    'is_ascending_order' => false,
    'per_page' => 25,
    'page' => 1
  ]),
  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  \"location_ids\": [\n    357,\n    419\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  \"functions\": [\n    \"engineering\",\n    \"product_management\"\n  ],\n  \"departments\": [\n    \"master_sales\"\n  ],\n  \"exclude_departments\": [\n    \"c_suite\"\n  ],\n  \"seniority_ranks\": [\n    4,\n    5\n  ],\n  \"posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"launch_dates\": [\n    \"2026-08-01\",\n    \"2026-08-31\"\n  ],\n  \"created_at\": \"2026-09-02T12:00:00Z\",\n  \"is_realtime_enrichment\": true,\n  \"is_ascending_order\": false,\n  \"per_page\": 25,\n  \"page\": 1\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  \"location_ids\": [\n    357,\n    419\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  \"functions\": [\n    \"engineering\",\n    \"product_management\"\n  ],\n  \"departments\": [\n    \"master_sales\"\n  ],\n  \"exclude_departments\": [\n    \"c_suite\"\n  ],\n  \"seniority_ranks\": [\n    4,\n    5\n  ],\n  \"posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"launch_dates\": [\n    \"2026-08-01\",\n    \"2026-08-31\"\n  ],\n  \"created_at\": \"2026-09-02T12:00:00Z\",\n  \"is_realtime_enrichment\": true,\n  \"is_ascending_order\": false,\n  \"per_page\": 25,\n  \"page\": 1\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  \"location_ids\": [\n    357,\n    419\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  \"functions\": [\n    \"engineering\",\n    \"product_management\"\n  ],\n  \"departments\": [\n    \"master_sales\"\n  ],\n  \"exclude_departments\": [\n    \"c_suite\"\n  ],\n  \"seniority_ranks\": [\n    4,\n    5\n  ],\n  \"posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"launch_dates\": [\n    \"2026-08-01\",\n    \"2026-08-31\"\n  ],\n  \"created_at\": \"2026-09-02T12:00:00Z\",\n  \"is_realtime_enrichment\": true,\n  \"is_ascending_order\": false,\n  \"per_page\": 25,\n  \"page\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "metadata": {
    "profile": null,
    "filters": {
      "domains": [
        "google.com"
      ],
      "per_page": 25,
      "language": "en"
    },
    "ignored_fields": []
  },
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 2228628,
      "total_pages": 89146,
      "is_timeout": false,
      "total_display_pages": 250
    },
    "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",
        "created_at": "2025-05-10T14:30:58.348Z",
        "source_type": "linkedin",
        "functions": null,
        "seniority_rank": 0,
        "base_salary": null,
        "experience_requirement": null,
        "education_requirement": null,
        "employment_type": null
      },
      "..."
    ]
  }
}

{
  "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"]

location_ids

integer[]

按 Pubrio location_id 指定职位所在国家（来自 Locations 端点，每行也会返回）。locations 的替代方式。

示例:

[357, 419]

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"]

functions

string[]

根据职位名称派生的职能 slug，例如 engineering、sales、marketing、finance、product_management，或 software_development 等部门职能 slug，不区分大小写。未知 slug 不匹配任何结果。完整列表见枚举与常量。

示例:

["engineering", "product_management"]

departments

string[]

部门 slug 或名称，例如 master_sales 或 Sales（不区分大小写），取自部门。匹配职位名称带有其中任一部门的职位；目录中没有的值不匹配任何结果。

示例:

["master_sales"]

exclude_departments

string[]

要排除的部门 slug 或名称。没有部门的职位会保留。

示例:

["c_suite"]

seniority_ranks

enum<integer>[]

根据职位名称解析的职级：1 初级、2 资深、3 经理、4 总监、5 高管。1–5 以外的值不会匹配任何结果。结果行在 seniority_rank 中返回层级（0 = 未分类）。

可用选项:

1,

2,

3,

4,

5

示例:

[4, 5]

posted_dates

string[]

发布日期的时间范围。最大值为当天。日期边界遵循你的工作区时区。

示例:

["2025-01-01", "2025-01-10"]

launch_dates

string<date>[]

上线日期的闭区间 [from, to]（UTC）：使用 posting_date，缺失时使用抓取日期。与职位洞察的计数方式一致。只传一个日期则匹配当天。

Required array length: 1 - 2 elements

示例:

["2026-08-01", "2026-08-31"]

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

每页记录数。默认 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

请求上下文。

Show child attributes

data

object

Show child attributes

最后修改于 2025年6月9日