Skip to main content
POST
/
companies
/
jobs
/
insights
Job posting insights
curl --request POST \
  --url https://api.pubrio.com/companies/jobs/insights \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "date_from": "2026-01-01",
  "date_to": "2026-03-31",
  "profile_id": 123
}
'
import requests

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

payload = {
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"date_from": "2026-01-01",
"date_to": "2026-03-31",
"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({
domain_search_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
date_from: '2026-01-01',
date_to: '2026-03-31',
profile_id: 123
})
};

fetch('https://api.pubrio.com/companies/jobs/insights', 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/insights",
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([
'domain_search_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'date_from' => '2026-01-01',
'date_to' => '2026-03-31',
'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/insights"

payload := strings.NewReader("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"date_from\": \"2026-01-01\",\n \"date_to\": \"2026-03-31\",\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/insights")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"date_from\": \"2026-01-01\",\n \"date_to\": \"2026-03-31\",\n \"profile_id\": 123\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/companies/jobs/insights")

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 \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"date_from\": \"2026-01-01\",\n \"date_to\": \"2026-03-31\",\n \"profile_id\": 123\n}"

response = http.request(request)
puts response.read_body
{
  "data": {
    "totals": {
      "open": 124,
      "new_in_window": 31,
      "functions": 6,
      "locations": 4
    },
    "seniority": {
      "classified": 28,
      "leadership": 5,
      "tiers": [
        {
          "key": "leadership",
          "rank": 5,
          "count": 5
        },
        {
          "key": "senior",
          "rank": 3,
          "count": 12
        }
      ]
    },
    "postings": [
      {
        "title": "Country Manager",
        "country_code": "GB",
        "posted_at": "2026-02-14"
      }
    ],
    "weekly_series": [
      {
        "week_start": "2026-02-09",
        "count": 8
      }
    ],
    "breakdown_function": [
      {
        "key": "sales",
        "count": 11
      },
      {
        "key": "engineering",
        "count": 7
      }
    ],
    "breakdown_department": [
      {
        "key": "go_to_market",
        "count": 9
      }
    ],
    "breakdown_location": [
      {
        "key": "GB",
        "count": 14
      }
    ],
    "window_days": 90
  }
}

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
domain_search_id
string<uuid>
required

A unique identifier for the company search operation.

date_from
string<date>

Start of the date window (ISO 8601, YYYY-MM-DD). Use together with date_to to scope results to a specific range; omit both to use the default window.

Example:

"2026-01-01"

date_to
string<date>

End of the date window (ISO 8601, YYYY-MM-DD). Must be on or after date_from.

Example:

"2026-03-31"

profile_id
integer

Optional. An identifier for the user profile (workspace) making the request. This is no longer required as the API key already includes your workspace information. If provided, it helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking.

Check out user details endpoints under the Profile tab for more information.

Response

200 - application/json

Hiring insight bands for the company and window.

data
object

Insight bands for the requested company and window.