Company Job Search

Search for job postings

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
}
'

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
}
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
  })
};

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
  ]),
  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}")

	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}")
  .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}"

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": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}

{
  "error": "Request rate limit exceeded. Please wait and try again later."
}

{
  "error": "An unexpected error occurred on the server."
}

POST

companies

jobs

Search for job postings

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
}
'

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
}
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
  })
};

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
  ]),
  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}")

	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}")
  .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}"

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": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}

{
  "error": "Request rate limit exceeded. Please wait and try again later."
}

{
  "error": "An unexpected error occurred on the server."
}

Authorizations

pubrio-api-key

string

header

required

A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the Settings section.

Body

application/json

locations

string[]

ISO 3166-1 alpha-2 (cca2) is used for filtering locations. Check out location endpoints under the Filters tab for more information.

Example:

["US", "SG", "CN"]

exclude_locations

string[]

ISO 3166-1 alpha-2 (cca2) location codes to exclude from job results. Check out the location endpoints under the Filters tab for valid codes.

Example:

["TW"]

company_locations

string[]

The location of the company headquarters. Check out location endpoints under the Filters tab for more information.

Example:

["US", "SG", "CN"]

companies

string<uuid>[]

A list of unique identifiers (domain_search_id) used for company and people search operations.

domains

string[]

List of company domains used for company and people search operations. If we receive a URL such as www.pubrio.com or https://docs.pubrio.com/, the system will convert it to pubrio.com for processing.

Example:

["pubrio.com"]

linkedin_urls

string[]

The fully formed URL of the LinkedIn company profile. URL begin with http and contain linkedin.com/company/

Example:

["https://www.linkedin.com/company/pubrio"]

search_term

string

A string of words over which we want to filter the results.

Example:

"pubrio"

search_terms

string[]

Array of keyword strings to filter job postings. Each term is matched against job content. Use search_term for a single string or search_terms for multiple keywords.

Example:

["Software Developer"]

titles

string[]

Job titles associated with the individuals you aim to locate.

The results will also encompass job titles that include similar terminology, even if they do not match exactly. For instance, searching for software engineer may yield results for individuals with the title senior software engineer.

Example:

["sales manager", "marketing manager"]

posted_dates

string[]

Date range of the posted date. The maximum value is the current day.

Example:

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

is_realtime_enrichment

boolean

default:false

Opt into realtime enrichment for a single, company-scoped query (filtered by domain_search_id, domains, or linkedin_urls). When the initial search returns zero results, the endpoint scrapes the source, persists the records, and re-runs the search before responding. Subject to a per-route deadline.

Example:

true

per_page

integer

default:25

Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's max_search_per_page, returned by Profile. Exceeding it returns HTTP 416 with code 41676 (or 41613 on company and people search), not a clamped result set.

Required range: x <= 25

Example:

25

page

integer

default:1

Page number, starting at 1. The ceiling is your subscription's max_search_page (max_company_search_page for company search), returned by Profile. Exceeding it returns HTTP 416.

Example:

1

Response

Successful response containing company job search details.

metadata

object

Request context: the echoed filters and a profile block with credit, topup_credit and total_credit_cost.

data

object | null

Response info depends on specific endpoint.

API Documentation

Endpoint

Authorizations

Body

Response