메인 콘텐츠로 건너뛰기
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입니다. 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

페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다.

예시:

25

​
page
integer

조회할 데이터 페이지 번호입니다.

예시:

1

​
profile_id
integer

선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.

자세한 내용은 팀 탭의 user details 엔드포인트를 참고하세요.

응답

관련 세부 정보가 포함된 성공적인 응답입니다.

​
data
object | null

응답 정보는 특정 API에 따라 다릅니다.