Search Jobs

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/search \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_titles": [
    "<string>"
  ],
  "keywords": [
    "<string>"
  ],
  "company_keywords": [
    "<string>"
  ],
  "location_types": [
    "<string>"
  ],
  "geo_locations": [
    {
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    }
  ],
  "geofilter_params": {
    "mode": "<string>",
    "radius": 123,
    "unit": "<string>"
  },
  "experience": [
    "<string>"
  ],
  "yoe": {
    "min": 123,
    "max": 123
  },
  "job_types": [
    "<string>"
  ],
  "job_category": [
    "<string>"
  ],
  "company_types": [
    "<string>"
  ],
  "job_board": [
    "<string>"
  ],
  "company_name": "<string>",
  "company_slug": "<string>",
  "salary": {
    "min": 123,
    "max": 123
  },
  "industry": [
    "<string>"
  ],
  "days_ago": 123,
  "date_posted": "<string>",
  "currency": "<string>",
  "visa": "<string>",
  "hide_recruiting_agencies": "<string>",
  "include_no_salary": "<string>",
  "include_yoe": "<string>",
  "hide_seen_jobs": "<string>",
  "filter_incomplete_jobs": "<string>",
  "return_raw_description": "<string>",
  "sort_by": "<string>",
  "sort_order": "<string>",
  "page": 123,
  "limit": 123
}
'

import requests

url = "https://api.hirebase.org/v2/jobs/search"

payload = {
    "job_titles": ["<string>"],
    "keywords": ["<string>"],
    "company_keywords": ["<string>"],
    "location_types": ["<string>"],
    "geo_locations": [
        {
            "city": "<string>",
            "region": "<string>",
            "country": "<string>"
        }
    ],
    "geofilter_params": {
        "mode": "<string>",
        "radius": 123,
        "unit": "<string>"
    },
    "experience": ["<string>"],
    "yoe": {
        "min": 123,
        "max": 123
    },
    "job_types": ["<string>"],
    "job_category": ["<string>"],
    "company_types": ["<string>"],
    "job_board": ["<string>"],
    "company_name": "<string>",
    "company_slug": "<string>",
    "salary": {
        "min": 123,
        "max": 123
    },
    "industry": ["<string>"],
    "days_ago": 123,
    "date_posted": "<string>",
    "currency": "<string>",
    "visa": "<string>",
    "hide_recruiting_agencies": "<string>",
    "include_no_salary": "<string>",
    "include_yoe": "<string>",
    "hide_seen_jobs": "<string>",
    "filter_incomplete_jobs": "<string>",
    "return_raw_description": "<string>",
    "sort_by": "<string>",
    "sort_order": "<string>",
    "page": 123,
    "limit": 123
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_titles: ['<string>'],
    keywords: ['<string>'],
    company_keywords: ['<string>'],
    location_types: ['<string>'],
    geo_locations: [{city: '<string>', region: '<string>', country: '<string>'}],
    geofilter_params: {mode: '<string>', radius: 123, unit: '<string>'},
    experience: ['<string>'],
    yoe: {min: 123, max: 123},
    job_types: ['<string>'],
    job_category: ['<string>'],
    company_types: ['<string>'],
    job_board: ['<string>'],
    company_name: '<string>',
    company_slug: '<string>',
    salary: {min: 123, max: 123},
    industry: ['<string>'],
    days_ago: 123,
    date_posted: '<string>',
    currency: '<string>',
    visa: '<string>',
    hide_recruiting_agencies: '<string>',
    include_no_salary: '<string>',
    include_yoe: '<string>',
    hide_seen_jobs: '<string>',
    filter_incomplete_jobs: '<string>',
    return_raw_description: '<string>',
    sort_by: '<string>',
    sort_order: '<string>',
    page: 123,
    limit: 123
  })
};

fetch('https://api.hirebase.org/v2/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.hirebase.org/v2/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([
    'job_titles' => [
        '<string>'
    ],
    'keywords' => [
        '<string>'
    ],
    'company_keywords' => [
        '<string>'
    ],
    'location_types' => [
        '<string>'
    ],
    'geo_locations' => [
        [
                'city' => '<string>',
                'region' => '<string>',
                'country' => '<string>'
        ]
    ],
    'geofilter_params' => [
        'mode' => '<string>',
        'radius' => 123,
        'unit' => '<string>'
    ],
    'experience' => [
        '<string>'
    ],
    'yoe' => [
        'min' => 123,
        'max' => 123
    ],
    'job_types' => [
        '<string>'
    ],
    'job_category' => [
        '<string>'
    ],
    'company_types' => [
        '<string>'
    ],
    'job_board' => [
        '<string>'
    ],
    'company_name' => '<string>',
    'company_slug' => '<string>',
    'salary' => [
        'min' => 123,
        'max' => 123
    ],
    'industry' => [
        '<string>'
    ],
    'days_ago' => 123,
    'date_posted' => '<string>',
    'currency' => '<string>',
    'visa' => '<string>',
    'hide_recruiting_agencies' => '<string>',
    'include_no_salary' => '<string>',
    'include_yoe' => '<string>',
    'hide_seen_jobs' => '<string>',
    'filter_incomplete_jobs' => '<string>',
    'return_raw_description' => '<string>',
    'sort_by' => '<string>',
    'sort_order' => '<string>',
    'page' => 123,
    'limit' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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.hirebase.org/v2/jobs/search"

	payload := strings.NewReader("{\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"company_keywords\": [\n    \"<string>\"\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"geo_locations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"geofilter_params\": {\n    \"mode\": \"<string>\",\n    \"radius\": 123,\n    \"unit\": \"<string>\"\n  },\n  \"experience\": [\n    \"<string>\"\n  ],\n  \"yoe\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"job_types\": [\n    \"<string>\"\n  ],\n  \"job_category\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"job_board\": [\n    \"<string>\"\n  ],\n  \"company_name\": \"<string>\",\n  \"company_slug\": \"<string>\",\n  \"salary\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"date_posted\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"visa\": \"<string>\",\n  \"hide_recruiting_agencies\": \"<string>\",\n  \"include_no_salary\": \"<string>\",\n  \"include_yoe\": \"<string>\",\n  \"hide_seen_jobs\": \"<string>\",\n  \"filter_incomplete_jobs\": \"<string>\",\n  \"return_raw_description\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	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.hirebase.org/v2/jobs/search")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"company_keywords\": [\n    \"<string>\"\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"geo_locations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"geofilter_params\": {\n    \"mode\": \"<string>\",\n    \"radius\": 123,\n    \"unit\": \"<string>\"\n  },\n  \"experience\": [\n    \"<string>\"\n  ],\n  \"yoe\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"job_types\": [\n    \"<string>\"\n  ],\n  \"job_category\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"job_board\": [\n    \"<string>\"\n  ],\n  \"company_name\": \"<string>\",\n  \"company_slug\": \"<string>\",\n  \"salary\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"date_posted\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"visa\": \"<string>\",\n  \"hide_recruiting_agencies\": \"<string>\",\n  \"include_no_salary\": \"<string>\",\n  \"include_yoe\": \"<string>\",\n  \"hide_seen_jobs\": \"<string>\",\n  \"filter_incomplete_jobs\": \"<string>\",\n  \"return_raw_description\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"company_keywords\": [\n    \"<string>\"\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"geo_locations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"geofilter_params\": {\n    \"mode\": \"<string>\",\n    \"radius\": 123,\n    \"unit\": \"<string>\"\n  },\n  \"experience\": [\n    \"<string>\"\n  ],\n  \"yoe\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"job_types\": [\n    \"<string>\"\n  ],\n  \"job_category\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"job_board\": [\n    \"<string>\"\n  ],\n  \"company_name\": \"<string>\",\n  \"company_slug\": \"<string>\",\n  \"salary\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"date_posted\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"visa\": \"<string>\",\n  \"hide_recruiting_agencies\": \"<string>\",\n  \"include_no_salary\": \"<string>\",\n  \"include_yoe\": \"<string>\",\n  \"hide_seen_jobs\": \"<string>\",\n  \"filter_incomplete_jobs\": \"<string>\",\n  \"return_raw_description\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}"

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

{
    "jobs": [
        {
            "_id": "6a2f14a48bea0df96e26ac7b",
            "company_name": "CompanyXYZ",
            "job_title": "Senior Python Engineer",
            "job_title_raw": "Senior Python Engineer - Remote",
            "description": "<p>… cleaned/summarized description …</p>",
            "application_link": "https://jobs.workable.com/view/nqSdYtJwQ/...",
            "job_categories": ["Software Engineer Jobs", "Engineering Jobs", "Information Technology Jobs"],
            "job_type": "Full Time",
            "location_type": "Remote",
            "location_raw": "TELECOMMUTE; British Columbia, Canada",
            "locations": [
                {
                    "city": null,
                    "region": null,
                    "country": "Canada",
                    "coordinates": {"type": "Point", "coordinates": [-123.12, 49.28]},
                    "bbox": [-123.2, 49.0, -122.9, 49.3],
                    "address": "British Columbia, Canada"
                }
            ],
            "salary_range": {"min": 150000, "max": 210000, "currency": "USD", "period": "yearly"},
            "yoe_range": {"min": 2, "max": 5},
            "experience_level": "Senior",
            "education_level": "Bachelor's degree",
            "skills": ["Python", "FastAPI", "Distributed systems"],
            "technologies": ["Python", "PostgreSQL", "AWS"],
            "benefits": ["401k matching", "Remote-first", "Equity"],
            "requirements_summary": "5+ years Python; distributed systems experience",
            "team": "Platform Engineering",
            "language": "en",
            "visa_sponsored": false,
            "recruiter_agency": false,
            "offers_equity": false,
            "date_posted": "2026-06-07",
            "job_board": "workable",
            "job_board_link": "https://jobs.workable.com/company/...",
            "job_slug": "senior-python-engineer-17",
            "company_slug": "companyxyz",
            "company_link": "companyxyz.com",
            "company_logo": "https://logos.hirebase.org/.../companyxyz-320x320-q95.jpg",
            "md5_hash": "d6b5d4e7b99d23b082b46e49c22c168f",
            "platform_job_id": "ad88b6ba-a905-4850-ad79-73beb0e97766",
            "coolness_score": 6.4,
            "flexibility_score": 6.1,
            "compensation_value_score": 6.0,
            "benefits_score": 5.0,
            "impact_autonomy_score": 7.1,
            "prestige_score": 5.2,
            "growth_score": 6.2,
            "meta_completeness": false,
            "company_data": {
                "description_summary": "CompanyXYZ builds …",
                "linkedin_link": "https://www.linkedin.com/company/companyxyz",
                "size_range": {"min": 51, "max": 200},
                "industries": ["Tech, Software & IT Services"],
                "subindustries": ["AI & ML"],
                "services": ["Platform", "APIs"],
                "type": "Startup",
                "is_recruiting_agency": false,
                "is_3rd_party_agency": false
            }
        }
    ],
    "total_count": 1,
    "company_count": 1,
    "page": 1,
    "limit": 10,
    "total_pages": 1
}

POST

jobs

Search Jobs

curl --request POST \
  --url https://api.hirebase.org/v2/jobs/search \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_titles": [
    "<string>"
  ],
  "keywords": [
    "<string>"
  ],
  "company_keywords": [
    "<string>"
  ],
  "location_types": [
    "<string>"
  ],
  "geo_locations": [
    {
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    }
  ],
  "geofilter_params": {
    "mode": "<string>",
    "radius": 123,
    "unit": "<string>"
  },
  "experience": [
    "<string>"
  ],
  "yoe": {
    "min": 123,
    "max": 123
  },
  "job_types": [
    "<string>"
  ],
  "job_category": [
    "<string>"
  ],
  "company_types": [
    "<string>"
  ],
  "job_board": [
    "<string>"
  ],
  "company_name": "<string>",
  "company_slug": "<string>",
  "salary": {
    "min": 123,
    "max": 123
  },
  "industry": [
    "<string>"
  ],
  "days_ago": 123,
  "date_posted": "<string>",
  "currency": "<string>",
  "visa": "<string>",
  "hide_recruiting_agencies": "<string>",
  "include_no_salary": "<string>",
  "include_yoe": "<string>",
  "hide_seen_jobs": "<string>",
  "filter_incomplete_jobs": "<string>",
  "return_raw_description": "<string>",
  "sort_by": "<string>",
  "sort_order": "<string>",
  "page": 123,
  "limit": 123
}
'

import requests

url = "https://api.hirebase.org/v2/jobs/search"

payload = {
    "job_titles": ["<string>"],
    "keywords": ["<string>"],
    "company_keywords": ["<string>"],
    "location_types": ["<string>"],
    "geo_locations": [
        {
            "city": "<string>",
            "region": "<string>",
            "country": "<string>"
        }
    ],
    "geofilter_params": {
        "mode": "<string>",
        "radius": 123,
        "unit": "<string>"
    },
    "experience": ["<string>"],
    "yoe": {
        "min": 123,
        "max": 123
    },
    "job_types": ["<string>"],
    "job_category": ["<string>"],
    "company_types": ["<string>"],
    "job_board": ["<string>"],
    "company_name": "<string>",
    "company_slug": "<string>",
    "salary": {
        "min": 123,
        "max": 123
    },
    "industry": ["<string>"],
    "days_ago": 123,
    "date_posted": "<string>",
    "currency": "<string>",
    "visa": "<string>",
    "hide_recruiting_agencies": "<string>",
    "include_no_salary": "<string>",
    "include_yoe": "<string>",
    "hide_seen_jobs": "<string>",
    "filter_incomplete_jobs": "<string>",
    "return_raw_description": "<string>",
    "sort_by": "<string>",
    "sort_order": "<string>",
    "page": 123,
    "limit": 123
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_titles: ['<string>'],
    keywords: ['<string>'],
    company_keywords: ['<string>'],
    location_types: ['<string>'],
    geo_locations: [{city: '<string>', region: '<string>', country: '<string>'}],
    geofilter_params: {mode: '<string>', radius: 123, unit: '<string>'},
    experience: ['<string>'],
    yoe: {min: 123, max: 123},
    job_types: ['<string>'],
    job_category: ['<string>'],
    company_types: ['<string>'],
    job_board: ['<string>'],
    company_name: '<string>',
    company_slug: '<string>',
    salary: {min: 123, max: 123},
    industry: ['<string>'],
    days_ago: 123,
    date_posted: '<string>',
    currency: '<string>',
    visa: '<string>',
    hide_recruiting_agencies: '<string>',
    include_no_salary: '<string>',
    include_yoe: '<string>',
    hide_seen_jobs: '<string>',
    filter_incomplete_jobs: '<string>',
    return_raw_description: '<string>',
    sort_by: '<string>',
    sort_order: '<string>',
    page: 123,
    limit: 123
  })
};

fetch('https://api.hirebase.org/v2/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.hirebase.org/v2/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([
    'job_titles' => [
        '<string>'
    ],
    'keywords' => [
        '<string>'
    ],
    'company_keywords' => [
        '<string>'
    ],
    'location_types' => [
        '<string>'
    ],
    'geo_locations' => [
        [
                'city' => '<string>',
                'region' => '<string>',
                'country' => '<string>'
        ]
    ],
    'geofilter_params' => [
        'mode' => '<string>',
        'radius' => 123,
        'unit' => '<string>'
    ],
    'experience' => [
        '<string>'
    ],
    'yoe' => [
        'min' => 123,
        'max' => 123
    ],
    'job_types' => [
        '<string>'
    ],
    'job_category' => [
        '<string>'
    ],
    'company_types' => [
        '<string>'
    ],
    'job_board' => [
        '<string>'
    ],
    'company_name' => '<string>',
    'company_slug' => '<string>',
    'salary' => [
        'min' => 123,
        'max' => 123
    ],
    'industry' => [
        '<string>'
    ],
    'days_ago' => 123,
    'date_posted' => '<string>',
    'currency' => '<string>',
    'visa' => '<string>',
    'hide_recruiting_agencies' => '<string>',
    'include_no_salary' => '<string>',
    'include_yoe' => '<string>',
    'hide_seen_jobs' => '<string>',
    'filter_incomplete_jobs' => '<string>',
    'return_raw_description' => '<string>',
    'sort_by' => '<string>',
    'sort_order' => '<string>',
    'page' => 123,
    'limit' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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.hirebase.org/v2/jobs/search"

	payload := strings.NewReader("{\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"company_keywords\": [\n    \"<string>\"\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"geo_locations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"geofilter_params\": {\n    \"mode\": \"<string>\",\n    \"radius\": 123,\n    \"unit\": \"<string>\"\n  },\n  \"experience\": [\n    \"<string>\"\n  ],\n  \"yoe\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"job_types\": [\n    \"<string>\"\n  ],\n  \"job_category\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"job_board\": [\n    \"<string>\"\n  ],\n  \"company_name\": \"<string>\",\n  \"company_slug\": \"<string>\",\n  \"salary\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"date_posted\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"visa\": \"<string>\",\n  \"hide_recruiting_agencies\": \"<string>\",\n  \"include_no_salary\": \"<string>\",\n  \"include_yoe\": \"<string>\",\n  \"hide_seen_jobs\": \"<string>\",\n  \"filter_incomplete_jobs\": \"<string>\",\n  \"return_raw_description\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	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.hirebase.org/v2/jobs/search")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"company_keywords\": [\n    \"<string>\"\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"geo_locations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"geofilter_params\": {\n    \"mode\": \"<string>\",\n    \"radius\": 123,\n    \"unit\": \"<string>\"\n  },\n  \"experience\": [\n    \"<string>\"\n  ],\n  \"yoe\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"job_types\": [\n    \"<string>\"\n  ],\n  \"job_category\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"job_board\": [\n    \"<string>\"\n  ],\n  \"company_name\": \"<string>\",\n  \"company_slug\": \"<string>\",\n  \"salary\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"date_posted\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"visa\": \"<string>\",\n  \"hide_recruiting_agencies\": \"<string>\",\n  \"include_no_salary\": \"<string>\",\n  \"include_yoe\": \"<string>\",\n  \"hide_seen_jobs\": \"<string>\",\n  \"filter_incomplete_jobs\": \"<string>\",\n  \"return_raw_description\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/jobs/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_titles\": [\n    \"<string>\"\n  ],\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"company_keywords\": [\n    \"<string>\"\n  ],\n  \"location_types\": [\n    \"<string>\"\n  ],\n  \"geo_locations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"geofilter_params\": {\n    \"mode\": \"<string>\",\n    \"radius\": 123,\n    \"unit\": \"<string>\"\n  },\n  \"experience\": [\n    \"<string>\"\n  ],\n  \"yoe\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"job_types\": [\n    \"<string>\"\n  ],\n  \"job_category\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"job_board\": [\n    \"<string>\"\n  ],\n  \"company_name\": \"<string>\",\n  \"company_slug\": \"<string>\",\n  \"salary\": {\n    \"min\": 123,\n    \"max\": 123\n  },\n  \"industry\": [\n    \"<string>\"\n  ],\n  \"days_ago\": 123,\n  \"date_posted\": \"<string>\",\n  \"currency\": \"<string>\",\n  \"visa\": \"<string>\",\n  \"hide_recruiting_agencies\": \"<string>\",\n  \"include_no_salary\": \"<string>\",\n  \"include_yoe\": \"<string>\",\n  \"hide_seen_jobs\": \"<string>\",\n  \"filter_incomplete_jobs\": \"<string>\",\n  \"return_raw_description\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}"

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

{
    "jobs": [
        {
            "_id": "6a2f14a48bea0df96e26ac7b",
            "company_name": "CompanyXYZ",
            "job_title": "Senior Python Engineer",
            "job_title_raw": "Senior Python Engineer - Remote",
            "description": "<p>… cleaned/summarized description …</p>",
            "application_link": "https://jobs.workable.com/view/nqSdYtJwQ/...",
            "job_categories": ["Software Engineer Jobs", "Engineering Jobs", "Information Technology Jobs"],
            "job_type": "Full Time",
            "location_type": "Remote",
            "location_raw": "TELECOMMUTE; British Columbia, Canada",
            "locations": [
                {
                    "city": null,
                    "region": null,
                    "country": "Canada",
                    "coordinates": {"type": "Point", "coordinates": [-123.12, 49.28]},
                    "bbox": [-123.2, 49.0, -122.9, 49.3],
                    "address": "British Columbia, Canada"
                }
            ],
            "salary_range": {"min": 150000, "max": 210000, "currency": "USD", "period": "yearly"},
            "yoe_range": {"min": 2, "max": 5},
            "experience_level": "Senior",
            "education_level": "Bachelor's degree",
            "skills": ["Python", "FastAPI", "Distributed systems"],
            "technologies": ["Python", "PostgreSQL", "AWS"],
            "benefits": ["401k matching", "Remote-first", "Equity"],
            "requirements_summary": "5+ years Python; distributed systems experience",
            "team": "Platform Engineering",
            "language": "en",
            "visa_sponsored": false,
            "recruiter_agency": false,
            "offers_equity": false,
            "date_posted": "2026-06-07",
            "job_board": "workable",
            "job_board_link": "https://jobs.workable.com/company/...",
            "job_slug": "senior-python-engineer-17",
            "company_slug": "companyxyz",
            "company_link": "companyxyz.com",
            "company_logo": "https://logos.hirebase.org/.../companyxyz-320x320-q95.jpg",
            "md5_hash": "d6b5d4e7b99d23b082b46e49c22c168f",
            "platform_job_id": "ad88b6ba-a905-4850-ad79-73beb0e97766",
            "coolness_score": 6.4,
            "flexibility_score": 6.1,
            "compensation_value_score": 6.0,
            "benefits_score": 5.0,
            "impact_autonomy_score": 7.1,
            "prestige_score": 5.2,
            "growth_score": 6.2,
            "meta_completeness": false,
            "company_data": {
                "description_summary": "CompanyXYZ builds …",
                "linkedin_link": "https://www.linkedin.com/company/companyxyz",
                "size_range": {"min": 51, "max": 200},
                "industries": ["Tech, Software & IT Services"],
                "subindustries": ["AI & ML"],
                "services": ["Platform", "APIs"],
                "type": "Startup",
                "is_recruiting_agency": false,
                "is_3rd_party_agency": false
            }
        }
    ],
    "total_count": 1,
    "company_count": 1,
    "page": 1,
    "limit": 10,
    "total_pages": 1
}

Search for jobs using common filters such as job titles, experience level, salary range, etc., in the JSON request body. All requests require an API key (x-api-key header) — see Authentication. API calls bill 1 unit of m_jobs_api_calls per job returned — see Usage Headers & Metering. The easiest way to start using our API is to use our Export button on our Search Page, this allows you to edit the tune the request using our Job Filters UI and easily export as a Javascript or cURL request.

Endpoint

POST /v2/jobs/search

Request Body

Use job_types (plural) — job_type (singular) is silently ignored and your filter will not apply.

Note:

All request body fields are optional.
Filter combinations can be mixed and matched.
Use specific filters to narrow down search results and obtain relevant matches.

string[]

Array of job titles to search for (matched against the parsed job_title field). Multiple entries are OR’d together. Each entry supports the following syntax:

Unquoted, multi-word ("data scientist" as a JSON string) — matches titles containing all of the words, in any order or position. Example match: “Scientist/Sr. Scientist, Bioinformatics Data”.
Quoted ("\"data scientist\"" — escaped quotes inside the JSON string) — matches the exact phrase only.
- prefix ("-senior") — excludes titles containing the term. Works in any position in the array.

Example — engineers, but not senior ones, plus exact-phrase data scientists:

{ "job_titles": ["engineer", "-senior", "\"data scientist\""] }

Special characters: Slashes are supported ("AI/ML Engineer" works). Parentheses and square brackets are not accepted and return a 422 validation error. Avoid a spaced hyphen ("engineer - data") inside a title — it currently returns a 500 error.

string[]

Array of keywords matched against description, technologies, skills, and benefits. Multiple entries are OR’d together.Keywords are a relevance signal, not a hard filter: results containing the exact phrase rank highest, followed by results containing all of the words, then results containing any of the words. Rare phrases will still return partial matches rather than zero results.Prefix an entry with - to exclude jobs matching it, e.g. ["machine learning", "-blockchain"]. A keywords array may consist solely of exclusions. Exclusions apply to the same four fields — they do not apply to job titles, so use job_titles negation for that.

⚠️ Multi-word exclusions are word-level, not phrase-level. A multi-word exclusion excludes jobs containing any of its words, not just the exact phrase. "-language models" excludes jobs mentioning “language” or “models” — including e.g. “predictive models”. For precise exclusions, prefer single distinctive words.

string[]

Array of keywords to match in company descriptions, services, and products

string[]

Array of work arrangements. Accepted values: "Remote", "Hybrid", "In-Person".

object[]

Array of structured location objects with city, region, and country.

Show child attributes

string

City name

string

State, region, or province

string

Country name

object

Geographic filtering configuration

Geo filtering is approximate — results are weighted toward the target area but may include some out-of-radius locations, especially in auto mode. The default (auto) performs metro-area fuzzy matching, not exact-city matching: searching a city will also return jobs in its surrounding metro area. Use mode: "strict" if you need exact location matching.

Show child attributes

string

Filtering mode for geographic search; ‘auto’, ‘weak’, ‘strict’, ‘box’ (defaults to: ‘auto’).

Weak: uses coordinate based matching
Strict: uses exact matching
Box: uses bounding box matching
Auto: uses heuristics to pick the optimal matching mechanism (recommended)

number

Search radius for geographic filtering (defaults to 25.0)

string

Units for radius; ‘mi’, ‘km’, ‘degrees’ (defaults to: ‘mi’)

string[]

Array of experience levels. Accepted values: "Entry", "Junior", "Mid", "Senior", "Executive".

Any other value will return a 422 Unprocessable Entity error.

object

Years of experience range object

Show child attributes

number

Minimum years of experience

number

Maximum years of experience

string[]

Array of employment types. Accepted values: "Full Time", "Part Time", "Contract", "Internship".

The "Contract" value matches roles whose returned job_type is "Contract / Temporary" — request token and response label differ.

The correct field name is job_types (plural). Using job_type (singular) is silently ignored — the request succeeds but the filter is not applied.

string[]

Filter by one or more job category tags (e.g., "Engineering Jobs", "Marketing Jobs"). See the full category list.

string[]

Filter jobs by the hiring company’s headcount bucket. Accepted values: "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10000+". Pass multiple values to combine ranges (e.g., ["11-50", "51-200"]).

This parameter is named company_types for historical reasons but currently filters by company size. A separate classification filter (Public Company / Non-Profit / etc.) will be added in a future API update.

string[]

Filter by the source job board (e.g., “iCIMS”, “Lever”, “Greenhouse”).

string

Filter by specific company name

string

Filter by the unique company slug (used for deep linking or specific company targeting).

object

Salary range object

Show child attributes

number

Minimum salary

number

Maximum salary

string[]

Filter by industry sector. Can be a single string or an array of strings. See List Industries for accepted values.

integer

How many days ago to filter for. Days Ago set to 3 will return jobs posted on and after 3 days ago.

string

Filter by a specific posted date (format: YYYY-MM-DD). Returns jobs posted on or after this date.

string

Currency code to use when applying the salary filter (e.g., "USD", "EUR", "GBP").

string

Filter for jobs that offer visa sponsorship ("true" or "false").

string

Filter out recruiter agency repostings ("true" or "false").

string

Include jobs that do not specify a salary ("true" or "false") when a salary filter is applied.

string

Include jobs that do not specify years of experience ("true" or "false") when a yoe filter is applied.

string

Omit jobs the current user has already viewed ("true" or "false"). Requires user_id.

string

Filter out jobs with incomplete listing data ("true" or "false").

string

Set to "true" to include the full original HTML description from the ATS source on each job object.

Getting full job descriptions: By default, job results return a cleaned/summarized description field (~900 chars). To get the full original HTML description from the ATS source, set return_raw_description to "true" — each job will then include a description_raw field with the complete HTML (~7,000+ chars typically).

{
  "job_titles": ["Software Engineer"],
  "return_raw_description": "true",
  "limit": 5
}

description (always present) — cleaned/summarized version.
description_raw (only when return_raw_description: "true") — full original HTML from the ATS.

string

Field to sort results by. Accepted values: "relevance", "date_posted", "salary", "company", "yoe".

"company" orders by company prominence/size, not alphabetically by name. Invalid values are silently ignored and the default sort (relevance) is applied.

string

Sort direction ("asc" or "desc").

number

default:"1"

Page number for pagination

number

default:"10"

Number of results per page (maximum 100).

Values above 100 return 422. The pagination (page and limit) fields control the number of results returned and which subset of results is displayed.

Each job returned costs one unit of your jobs allowance, so limit is also your spend per call. The free plan includes 500 jobs a month: five calls at limit: 100 use all of it. On hard-capped plans a request whose limit exceeds the remaining allowance is refused with a 429 that states how many units are left. See Usage Headers & Metering.

Response

array

Array of job objects

Show child attributes

string

Unique identifier for the job

string

Title of the job

string

Unparsed job title as scraped from the source.

string

Full job description in HTML or plain text format

string

URL where candidates can apply for the job

array

Categories or tags associated with the job posting (e.g., “Engineering”, “Design”)

string

Employment type. One of: "Full Time", "Part Time", "Contract / Temporary", "Internship".

string

Work arrangement, such as “Remote”, “Hybrid”, or “In-Person”

string

Raw location string from the source job board (before normalization into locations).

array

Array of location objects

Show child attributes

string

Name of the city

string

Name of state or province

string

Name of the country

object

Coordinates (long/lat) in GeoJSON format

number[]

Bounding Box (x1, y1, x2, y2) of the location region it encompasses

string

Normalized geographical address based on Nominatim API

object|null

Salary range offered for the job. May be null if not specified

Show child attributes

number

Minimum salary

number

Maximum salary

string

Currency code (e.g., USD, CAD)

string

Pay period for the salary range. Observed values: "yearly", "monthly", "daily", "hourly".

This field is not fully normalized today — you may also see "year" (≡ "yearly") and "hour" (≡ "hourly"). Treat those as equivalent until normalized.

object | null

Required years of experience. May be null when the listing does not specify a range.

Show child attributes

number

Minimum years of experience

number

Maximum years of experience

string

Brief summary of key requirements or qualifications for the job

boolean

Indicates whether the job supports visa sponsorship

boolean

Indicates whether the listing was posted by a recruiting agency

boolean

Whether the listing mentions equity compensation.

string

Content hash of the listing.

string

The source ATS’s own job identifier.

string[]

List of skills mentioned in the job description

string

Team at the company hiring for the position

string[]

List of technologies mentioned in the job description

string[]

List of benefits mentioned in the job description

string

Required education level. One of: "No Education Required", "High school degree", "Associate degree", "Bachelor's degree", "Master's degree", "Doctoral degree".

string

The date when the job was posted. Format: YYYY-MM-DD

string

The name of the job board from which the listing was sourced (e.g., “iCIMS”). Source-board casing is not normalized in this endpoint’s response (e.g., "greenhouse" may appear lowercase).

string

Language the job posting is in

string

URL of the job board hosting the listing

string

URL-friendly identifier for the job (used in deep-linking)

string | null

Parsed experience tier for the role. Response values: "Entry-Level", "Junior / Associate", "Mid-Level", "Senior", "Principal / Staff / Lead", "Executive". May be null when not inferred.

These response labels differ from the request-side experience filter, which accepts the shorter enum ("Entry", "Junior", "Mid", "Senior", "Executive") and maps to years-of-experience bands.

string

Full original HTML description from the ATS source. Only present when return_raw_description: "true" is set on the request.

string | null

Contact email for the listing, when available. Paid users only.

string | null

Contact phone number for the listing, when available. Paid users only.

Dimension scores — when present, coolness_score, flexibility_score, compensation_value_score, benefits_score, impact_autonomy_score, prestige_score, and growth_score each use a 0–10 scale (higher is better).

number

Company/role “coolness” rating (0–10).

number

Work-flexibility rating (0–10) — remote/hybrid + work-life-balance signals.

number

Compensation competitiveness rating (0–10) vs role and geography.

number

Benefits package rating (0–10) based on listed benefits quality/quantity.

number

Role-level impact and autonomy rating (0–10).

number

Company/role prestige rating (0–10).

number

Career growth / learning opportunity rating (0–10).

boolean

Whether the parsed listing metadata is considered complete.

string

Name of the hiring company

string

URL-friendly identifier for the company (used in deep-linking)

string

Official website of the company

string

URL to the company’s logo image

object

Enriched company profile details

Show child attributes

string

Short description about the company’s mission or services

string | null

Link to the company’s LinkedIn profile

string[]

List of services that the company provides

object | null

Approximate number of employees

Show child attributes

number

Minimum number of employees

number

Maximum number of employees

array

List of industries the company belongs to (e.g., “Design”, “Healthcare”)

array

More specific categories under the industry (e.g., “Architecture”)

string | null

Categorical company type (e.g., "Startup", "Enterprise").

boolean | null

Whether the company is a recruiting/talent agency.

boolean | null

Whether the company is a third-party agency.

number

Total number of matching jobs for the query

number

Number of unique companies represented in the result set

number

Current page number in the response

number

Number of job results returned per page

number

Total number of available pages for the query

Rate limit: 100 requests per 60 seconds per API key. Exceeding it returns 429 with a Retry-After header. A 429 with X-Billing-Code: limit_exceeded is a plan quota, not a rate limit — see Error Handling.

Example Request

curl -X POST https://api.hirebase.org/v2/jobs/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "job_titles": ["Software Engineer"],
    "keywords": ["python", "backend"],
    "location_types": ["In-Person", "Hybrid"],
    "geo_locations": [
      {"city": "New York", "region": "New York", "country": "United States"}
    ],
    "geofilter_params": {"mode": "auto", "radius": 50, "unit": "mi"},
    "experience": ["Mid", "Senior"],
    "yoe": {"min": 2, "max": 8},
    "job_types": ["Full Time"],
    "salary": {"min": 100000, "max": 250000},
    "currency": "USD",
    "include_no_salary": "true",
    "days_ago": 30,
    "sort_by": "date_posted",
    "sort_order": "desc",
    "page": 1,
    "limit": 10
  }'

{
  "job_titles": ["Site/Civil Engineer"],
  "keywords": ["Graphics", "Exhibits", "Civil Engineering"],
  "location_types": ["Hybrid", "In-Person"],
  "geo_locations": [{"city": "Richmond", "region": "Virginia", "country": "United States"}],
  "experience": ["Entry"],
  "yoe": {"min": 1, "max": 6},
  "company_name": "CompanyXYZ",
  "salary": {"min": 80000, "max": 120000},
  "job_types": ["Full Time"],
  "industry": ["Design, Construction"],
  "visa": "true",
  "sort_by": "relevance",
  "sort_order": "desc",
  "page": 1,
  "limit": 10
}

{
    "jobs": [
        {
            "_id": "6a2f14a48bea0df96e26ac7b",
            "company_name": "CompanyXYZ",
            "job_title": "Senior Python Engineer",
            "job_title_raw": "Senior Python Engineer - Remote",
            "description": "<p>… cleaned/summarized description …</p>",
            "application_link": "https://jobs.workable.com/view/nqSdYtJwQ/...",
            "job_categories": ["Software Engineer Jobs", "Engineering Jobs", "Information Technology Jobs"],
            "job_type": "Full Time",
            "location_type": "Remote",
            "location_raw": "TELECOMMUTE; British Columbia, Canada",
            "locations": [
                {
                    "city": null,
                    "region": null,
                    "country": "Canada",
                    "coordinates": {"type": "Point", "coordinates": [-123.12, 49.28]},
                    "bbox": [-123.2, 49.0, -122.9, 49.3],
                    "address": "British Columbia, Canada"
                }
            ],
            "salary_range": {"min": 150000, "max": 210000, "currency": "USD", "period": "yearly"},
            "yoe_range": {"min": 2, "max": 5},
            "experience_level": "Senior",
            "education_level": "Bachelor's degree",
            "skills": ["Python", "FastAPI", "Distributed systems"],
            "technologies": ["Python", "PostgreSQL", "AWS"],
            "benefits": ["401k matching", "Remote-first", "Equity"],
            "requirements_summary": "5+ years Python; distributed systems experience",
            "team": "Platform Engineering",
            "language": "en",
            "visa_sponsored": false,
            "recruiter_agency": false,
            "offers_equity": false,
            "date_posted": "2026-06-07",
            "job_board": "workable",
            "job_board_link": "https://jobs.workable.com/company/...",
            "job_slug": "senior-python-engineer-17",
            "company_slug": "companyxyz",
            "company_link": "companyxyz.com",
            "company_logo": "https://logos.hirebase.org/.../companyxyz-320x320-q95.jpg",
            "md5_hash": "d6b5d4e7b99d23b082b46e49c22c168f",
            "platform_job_id": "ad88b6ba-a905-4850-ad79-73beb0e97766",
            "coolness_score": 6.4,
            "flexibility_score": 6.1,
            "compensation_value_score": 6.0,
            "benefits_score": 5.0,
            "impact_autonomy_score": 7.1,
            "prestige_score": 5.2,
            "growth_score": 6.2,
            "meta_completeness": false,
            "company_data": {
                "description_summary": "CompanyXYZ builds …",
                "linkedin_link": "https://www.linkedin.com/company/companyxyz",
                "size_range": {"min": 51, "max": 200},
                "industries": ["Tech, Software & IT Services"],
                "subindustries": ["AI & ML"],
                "services": ["Platform", "APIs"],
                "type": "Startup",
                "is_recruiting_agency": false,
                "is_3rd_party_agency": false
            }
        }
    ],
    "total_count": 1,
    "company_count": 1,
    "page": 1,
    "limit": 10,
    "total_pages": 1
}

Error Responses

422 Unprocessable Entity Error

Returns when the request contains invalid or improperly formatted data. Some possible reasons may include the following:

When the industry field is missing, not a string, or doesn’t match any value from the list of valid industries.
JSON decoding errors, such as malformed JSON or incorrect data types in the request body.

500 Internal Server Error

Returns when an unexpected error occurs on the server.

Also occurs during unhandled server-side failures or bugs that prevent the request from being processed.

Jobs API

Expired Jobs API

Hiring Manager API

Companies API

Insights API

Salary Benchmark API

Reference Data API

Resumes

Tasks API

Billing & Usage

Error Handling

Search Jobs

Endpoint

Request Body

Response

Example Request

Error Responses

​Endpoint

​Request Body

​Response

​Example Request

​Error Responses

Endpoint

Request Body

Response

Example Request

Error Responses