curl "https://connect.jobo.world/api/occupations" \
-H "X-Api-Key: $JOBO_API_KEY"import requests
url = "https://connect.jobo.world/api/occupations"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://connect.jobo.world/api/occupations', 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://connect.jobo.world/api/occupations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-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"
"net/http"
"io"
)
func main() {
url := "https://connect.jobo.world/api/occupations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://connect.jobo.world/api/occupations")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://connect.jobo.world/api/occupations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"version": "bc3b8e92359c22b8",
"categories": [
{
"name": "Healthcare",
"subcategories": [
{
"name": "Nursing",
"occupations": [
{
"id": "jobo:licensed-practical-nurse",
"name": "Licensed Practical Nurse",
"isco_code": "3221",
"onet_soc_codes": []
},
{
"id": "esco:8d3e8aaa-791b-4c75-a465-f3f827028f50",
"name": "Registered Nurse",
"isco_code": "2221",
"onet_soc_codes": [
"29-1141.00"
]
}
]
}
]
}
]
}{
"error": "Invalid or expired API key",
"api_version": "2026-08-31"
}{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
"title": "Not available in the sandbox",
"status": 404,
"code": "not_available_in_sandbox",
"detail": "Sandbox keys (jbe_test_…) serve job search, job and company lookups, Auto Apply applications, and reading mailboxes. Use a live key for every other endpoint.",
"instance": "/api/jobs/feed/managed"
}{
"error": "Rate limit exceeded",
"detail": "Per-minute JobSearch request limit of 180 exceeded. Try again shortly.",
"retry_after_seconds": 1,
"code": "rate_limit_exceeded",
"group": "JobSearch",
"api_version": "2026-08-31",
"upgrade_url": "https://enterprise.jobo.world/credits?plan=job_search&tier=1&src=api_429",
"top_up_url": "<string>",
"recommended_plan": {
"package_type": "job_search",
"tier": 2,
"name": "Job Search — Growth",
"monthly_price_usd": 199,
"included_jobs_per_month": 500000
}
}List occupations
The taxonomy behind every job’s occupation: categories, then subcategories, then about 3,000 occupations, in one response with no paging. Filter search with a category’s name in job_categories, a subcategory’s name in job_subcategories and an occupation’s id in occupation_ids.
Filter on occupation ids, never names: ids are stable; names can improve between releases. version changes when occupations or the hierarchy change, but display names can change without it, so refetch now and then rather than caching by version alone.
Free: never charges the wallet, but counts toward the Default rate limit.
Occupations come from the ESCO classification (European Commission) and O*NET-SOC codes from the O*NET database (USDOL/ETA), both under CC BY 4.0. See Open data licenses and attribution.
curl "https://connect.jobo.world/api/occupations" \
-H "X-Api-Key: $JOBO_API_KEY"import requests
url = "https://connect.jobo.world/api/occupations"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://connect.jobo.world/api/occupations', 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://connect.jobo.world/api/occupations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-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"
"net/http"
"io"
)
func main() {
url := "https://connect.jobo.world/api/occupations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://connect.jobo.world/api/occupations")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://connect.jobo.world/api/occupations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"version": "bc3b8e92359c22b8",
"categories": [
{
"name": "Healthcare",
"subcategories": [
{
"name": "Nursing",
"occupations": [
{
"id": "jobo:licensed-practical-nurse",
"name": "Licensed Practical Nurse",
"isco_code": "3221",
"onet_soc_codes": []
},
{
"id": "esco:8d3e8aaa-791b-4c75-a465-f3f827028f50",
"name": "Registered Nurse",
"isco_code": "2221",
"onet_soc_codes": [
"29-1141.00"
]
}
]
}
]
}
]
}{
"error": "Invalid or expired API key",
"api_version": "2026-08-31"
}{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
"title": "Not available in the sandbox",
"status": 404,
"code": "not_available_in_sandbox",
"detail": "Sandbox keys (jbe_test_…) serve job search, job and company lookups, Auto Apply applications, and reading mailboxes. Use a live key for every other endpoint.",
"instance": "/api/jobs/feed/managed"
}{
"error": "Rate limit exceeded",
"detail": "Per-minute JobSearch request limit of 180 exceeded. Try again shortly.",
"retry_after_seconds": 1,
"code": "rate_limit_exceeded",
"group": "JobSearch",
"api_version": "2026-08-31",
"upgrade_url": "https://enterprise.jobo.world/credits?plan=job_search&tier=1&src=api_429",
"top_up_url": "<string>",
"recommended_plan": {
"package_type": "job_search",
"tier": 2,
"name": "Job Search — Growth",
"monthly_price_usd": 199,
"included_jobs_per_month": 500000
}
}Authorizations
Your Jobo API key. Create one in the dashboard under Developers → API Keys. Live keys start with jbe_live_ and sandbox keys with jbe_test_.

