Get Company Jobs
curl --request GET \
--url https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobsimport requests
url = "https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs', 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/hirebase/companies/:company_slug/jobs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"jobs": [
{}
],
"job_categories": [
{
"category": "<string>"
}
],
"total_count": 123,
"page": 123,
"limit": 123,
"total_pages": 123
}Companies API
Get Company Jobs
Retrieve a paginated list of job openings for a specific company using its slug.
GET
/
v2
/
hirebase
/
companies
/
:company_slug
/
jobs
Get Company Jobs
curl --request GET \
--url https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobsimport requests
url = "https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs', 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/hirebase/companies/:company_slug/jobs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hirebase.org/v2/hirebase/companies/:company_slug/jobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"jobs": [
{}
],
"job_categories": [
{
"category": "<string>"
}
],
"total_count": 123,
"page": 123,
"limit": 123,
"total_pages": 123
}Display company-specific job listings on profile pages, highlight job opportunities from targeted companies, and track hiring trends by filtering jobs by category, employment type, and location type.
Endpoint
GET /v2/hirebase/companies/:company_slug/jobs
Path Parameters
string
required
Unique identifier for the target company to search
Authentication
string
Your Hirebase API key. Optional — not enforced on this endpoint today.
Query Parameters
integer
default:"1"
Page number for pagination
⚠️ Known issue: consecutive pages may return overlapping jobs. Deduplicate by
_id on the client until this is fixed.integer
default:"10"
Number of results per page
⚠️ Known issue: consecutive pages may return overlapping jobs. Deduplicate by
_id on the client until this is fixed.string
Field to sort results by. Accepted values:
"date_posted", "relevance", "salary", "yoe".⚠️ Not currently applied — results are returned in a default order regardless of
sort_by/sort_order.string
Sort direction (
"asc" or "desc").⚠️ Not currently applied — results are returned in a default order regardless of
sort_by/sort_order.string
Filter jobs by source job board (e.g.,
"iCIMS", "Greenhouse", "Lever", "Workable").string
Filter jobs by job category (e.g.,
"Engineering Jobs", "Sales Jobs").Response
array
An array of job objects associated with the company
Show child attributes
Show child attributes
string
Unique identifier for the job
string
Name of the company posting the job
string
Title or designation of the job
string
Full HTML-formatted job description, including responsibilities, requirements, and benefits
string
URL where users can apply for the job
string
Free-text version of the job location (e.g., “Dallas, TX, US”)
string[]
List of categories or tags associated with the job (e.g., “Engineering”, “Other”)
string
Employment type. One of:
"Full Time", "Part Time", "Contract / Temporary", "Internship".string
Work setup for the job, such as “Remote”, “Hybrid”, or “In-Person”
object
object | null
Salary details for the job. Can be null if not provided
Show child attributes
Show child attributes
number
Minimum salary offered
number
Maximum salary offered
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.string
Currency code for the salary range(e.g., “USD”). May be omitted if salary data is not available
string
Date the job was posted, in ISO format (YYYY-MM-DD)
string
Official website URL of the company
string
URL to the company’s logo image
string | null
Name of the job board where this job is hosted (e.g., “iCIMS”)
string | null
URL to the job board listing page for this company
string
Short plain-text summary of the core job requirements
boolean
Indicates whether the company sponsors visas for this job
boolean
Whether the parsed listing metadata is considered complete.
number
Internal signal (0–1) reflecting how targetable/complete the listing is for matching.
object
Basic company information relevant to this job. May duplicate the top-level company object
Show child attributes
Show child attributes
string
Brief description of the company
string
LinkedIn profile URL for the company
object
string[]
Primary industry categories the company operates in
string[]
More specific categories within the industries
string
URL-friendly identifier for the company
string
URL-friendly identifier for the job
boolean
Indicates whether the job posting has expired
array
Array of job category objects representing classifications of jobs (e.g., “Engineering Jobs”, “Human Resources Jobs”)
Show child attributes
Show child attributes
string
Name of the job category
number
Total number of matching job listings
number
Current page number of the response
number
Number of jobs returned per page
number
Total number of pages available for the query
Example Request
curl -X GET "https://api.hirebase.org/v2/hirebase/companies/companyxyz/jobs?page=1&limit=10" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY"
Example Response
{
"jobs": [
{
"_id": "652e6f6e8b858c1c6ad2bv42",
"company_name": "CompanyXYZ",
"job_title": "Mid level GIS Professional",
"description": "<p>CompanyXYZ is seeking a Mid-level GIS professional to work on projects in our Dallas TX Office. This is an excellent career opportunity for an experienced individual to join a team of professionals, while working in a multidisciplinary consulting and engineering firm.</p><h2>Requirements</h2><ul><li>Bachelor’s degree in geography or GIS degrees preferred</li><li>3 - 6 years of professional work experience in geography (preferably in FIRM production)</li><li>Knowledge of the National Flood Insurance Program (NFIP), FEMA Flood Insurance Studies, MT-2, and/or other flood study related programs and processes</li><li>Knowledge of FEMA Guidelines and Standards for Flood Risk Analysis and Mapping</li><li>Knowledge of FEMA's MIP tracking and reporting system a plus</li><li>Knowledge, interest, and project experience in GIS applications, including ArcGIS Desktop 10.x, ArcGIS Pro, and ArcGIS Online</li><li>Strong oral, people, and written communication skills</li><li>Strong MS Excel and MS Access skills to leverage various data sources for use in GIS projects</li><li>CFM (Certified Floodplain Manager) is a strong plus</li><li>Intermediate proficiency in python modeling/scripting and model builder for ArcGIS</li><li>Experience with GIS application and/or web development a plus</li><li>Intermediate experience with FEMA’s HAZUS application for multi-hazard risk analysis</li><li>Knowledge of Flood Mitigation and other Grant Programs a plus</li><li>Knowledge of Environmental Regulations a plus</li><li>Knowledge of Watershed Planning a plus</li></ul><h2>Benefits</h2><ul><li>Fantastic working environment</li><li>Opportunity to apply the latest technology to flood studies and water resource projects</li><li>Professional growth opportunity</li><li>Multidisciplinary consulting and engineering firm</li></ul>",
"application_link": "https://careers-companyxyz.icims.com/jobs/14289/mid-level-gis-professional/job",
"location_raw": "Dallas, TX, US",
"job_categories": [
"Other"
],
"job_type": "Full Time",
"location_type": "In-Person",
"yoe_range": {
"min": 3,
"max": 6
},
"salary_range": null,
"date_posted": "2025-03-07",
"company_link": "https://www.companyxyz.com",
"company_logo": "https://c-1720-20210302-www-companyxyz-com.i.icims.com/images/default-source/site-assets/logos/companyxyz-logo.png?sfvrsn=ba6fa825_0",
"job_board": "iCIMS",
"job_board_link": "https://careers-companyxyz.icims.com",
"requirements_summary": "Bachelor’s degree in geography or GIS degrees preferred, 3 - 6 years of professional work experience in geography, knowledge of GIS applications and flood study related programs and processes",
"visa_sponsored": false,
"meta_completeness": false,
"meta_targetability": 0.8,
"company_data": {
"description_summary": "CompanyXYZ provides professional services, creating innovative solutions for built and natural environments nationwide.",
"linkedin_link": "https://www.linkedin.com/company/companyxyz",
"size_range": {
"min": 1001,
"max": 5000
},
"industries": [
"Design",
"Construction"
],
"subindustries": [
"Architecture",
"Building Construction"
]
},
"company_slug": "companyxyz",
"job_slug": "mid-level-gis-professional-8",
"expired": false,
"locations": [
{
"city": "Dallas",
"region": "Texas",
"country": "United States"
}
]
},
{
"_id": "672e6f5f8b838d1c6ad2df62",
"company_name": "CompanyXYZ",
"job_title": "Senior Drainage Engineer",
"description": "<p>CompanyXYZ is seeking a Senior Drainage Engineer with strong organizational and technical skills to support our growing Transportation design practice. This position will be based in our Orlando, FL office and offers career advancement opportunities, an excellent working environment, great work-life balance, and the chance to work on a variety of impactful projects.</p><h2>Requirements</h2><ul><li>Serve as Engineer-of-Record, Senior Engineer, or Project Manager on Transportation projects</li><li>Perform and collaborate on drainage analyses with other Drainage staff</li><li>Prepare drainage plans, reports, construction quantities, cost estimates and specifications for transportation projects</li></ul><h2>Benefits</h2><ul><li>Comprehensive medical, dental, vision, and supplemental life insurance programs</li><li>401(k) profit sharing plan with employer matching</li><li>529 college savings plans</li></ul>",
"application_link": "https://careers-companyxyz.icims.com/jobs/14197/senior-drainage-engineer/job",
"location_raw": "Orlando, FL, US",
"job_categories": [
"Other"
],
"job_type": "Full Time",
"location_type": "Hybrid",
"yoe_range": {
"min": 7,
"max": 7
},
"salary_range": null,
"date_posted": "2025-03-07",
"company_link": "https://www.companyxyz.com",
"company_logo": "https://c-1720-20210302-www-companyxyz-com.i.icims.com/images/default-source/site-assets/logos/companyxyz-logo.png?sfvrsn=ba6fa825_0",
"job_board": "iCIMS",
"job_board_link": "https://careers-companyxyz.icims.com",
"requirements_summary": "Bachelor’s degree in Civil Engineering or a related discipline and 7+ years of relevant FDOT drainage/water resources design experience",
"visa_sponsored": true,
"meta_completeness": false,
"meta_targetability": 0.8,
"company_data": {
"description_summary": "CompanyXYZ provides professional services, creating innovative solutions for built and natural environments nationwide.",
"linkedin_link": "https://www.linkedin.com/company/companyxyz",
"size_range": {
"min": 1001,
"max": 5000
},
"industries": [
"Design",
"Construction"
],
"subindustries": [
"Architecture",
"Building Construction"
]
},
"company_slug": "companyxyz",
"job_slug": "senior-drainage-engineer-19",
"expired": false,
"locations": [
{
"city": "Orlando",
"region": "Florida",
"country": "United States"
}
]
}
],
"job_categories": [
{
"category": "Other"
}
],
"total_count": 161,
"page": 1,
"limit": 2,
"total_pages": 81
}
Error Responses
401 Unauthorized
401 Unauthorized
Returns when the
API key is missing, invalid, or incorrect.404 Not Found
404 Not Found
Returns when the specified
company_slugdoes not exist in the database.- The company does not exist or has been deleted.
- There’s a typo in the
company_slugvalue. - The slug is incorrectly cased (e.g., uppercase vs lowercase letters).
500 Internal Server Error
500 Internal Server Error
Returns when an unexpected error occurs on the server.
- Occurs during unhandled server-side failures or bugs that prevent the request from being processed.
Get a Single Company Job by Slug
Resolve acompany_slug + job_slug deep-link back to the full job record. This is what powers the SDK’s neural_search(company_slug=..., job_slug=...) “similar jobs” convenience.
Endpoint
GET /v2/hirebase/companies/:company_slug/jobs/:job_slug
Authentication
string
Your Hirebase API key. Optional — not enforced on this endpoint today (like the other company
GET endpoints).Path Parameters
string
required
URL-friendly identifier for the company.
string
required
URL-friendly identifier for the job.
Response
array
Array containing the matching job(s) for the slug. Each entry uses the same job object shape as the Get Company Jobs response above.
Example Request
curl -X GET "https://api.hirebase.org/v2/hirebase/companies/accenture/jobs/data-platform-engineer-803a8110" \
-H "x-api-key: YOUR_API_KEY"
Example Response
{
"jobs": [
{
"_id": "652e6f6e8b858c1c6ad2bv42",
"company_name": "Accenture",
"job_title": "Data Platform Engineer",
"company_slug": "accenture",
"job_slug": "data-platform-engineer-803a8110",
"job_type": "Full Time",
"location_type": "Hybrid",
"date_posted": "2026-06-01"
}
]
}