Get Company
curl --request GET \
--url https://api.hirebase.org/v2/hirebase/companies/:company_slugimport requests
url = "https://api.hirebase.org/v2/hirebase/companies/:company_slug"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.hirebase.org/v2/hirebase/companies/:company_slug', 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",
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"
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")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hirebase.org/v2/hirebase/companies/:company_slug")
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{
"company": {
"company_slug": "<string>",
"company_name": "<string>",
"company_logo": "<string>",
"job_board": {},
"linkedin_link": "<string>",
"company_link": "<string>",
"description_summary": "<string>",
"size_range": {
"min": 123,
"max": 123
},
"industries": [
"<string>"
],
"subindustries": [
"<string>"
],
"culture_summary": {},
"services": [
"<string>"
],
"clout": {},
"headquarters": {},
"founded": {},
"stock_info": {},
"funding_info": {},
"type": {},
"is_3rd_party_agency": {},
"is_recruiting_agency": {},
"mean_opinion_score": {},
"aliases": [
"<string>"
],
"parent_company": {},
"subsidiaries": [
"<string>"
]
},
"jobs": [
{
"_id": "<string>",
"company_name": "<string>",
"job_title": "<string>",
"description": "<string>",
"application_link": "<string>",
"location_raw": "<string>",
"job_categories": [
"<string>"
],
"job_type": "<string>",
"location_type": "<string>",
"yoe_range": {
"min": 123,
"max": 123
},
"salary_range": {
"min": 123,
"max": 123
},
"date_posted": "<string>",
"job_board": {},
"job_board_link": {},
"requirements_summary": "<string>",
"visa_sponsored": true,
"company_data": {
"description_summary": "<string>",
"linkedin_link": "<string>",
"size_range": {
"min": 123,
"max": 123
},
"industries": [
"<string>"
],
"subindustries": [
"<string>"
]
},
"company_slug": "<string>",
"job_slug": "<string>",
"expired": true,
"locations": [
{
"city": "<string>",
"region": "<string>",
"country": "<string>"
}
]
}
]
}Companies API
Get Company
Fetch detailed company profiles using a unique slug.
GET
/
v2
/
hirebase
/
companies
/
:company_slug
Get Company
curl --request GET \
--url https://api.hirebase.org/v2/hirebase/companies/:company_slugimport requests
url = "https://api.hirebase.org/v2/hirebase/companies/:company_slug"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.hirebase.org/v2/hirebase/companies/:company_slug', 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",
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"
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")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hirebase.org/v2/hirebase/companies/:company_slug")
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{
"company": {
"company_slug": "<string>",
"company_name": "<string>",
"company_logo": "<string>",
"job_board": {},
"linkedin_link": "<string>",
"company_link": "<string>",
"description_summary": "<string>",
"size_range": {
"min": 123,
"max": 123
},
"industries": [
"<string>"
],
"subindustries": [
"<string>"
],
"culture_summary": {},
"services": [
"<string>"
],
"clout": {},
"headquarters": {},
"founded": {},
"stock_info": {},
"funding_info": {},
"type": {},
"is_3rd_party_agency": {},
"is_recruiting_agency": {},
"mean_opinion_score": {},
"aliases": [
"<string>"
],
"parent_company": {},
"subsidiaries": [
"<string>"
]
},
"jobs": [
{
"_id": "<string>",
"company_name": "<string>",
"job_title": "<string>",
"description": "<string>",
"application_link": "<string>",
"location_raw": "<string>",
"job_categories": [
"<string>"
],
"job_type": "<string>",
"location_type": "<string>",
"yoe_range": {
"min": 123,
"max": 123
},
"salary_range": {
"min": 123,
"max": 123
},
"date_posted": "<string>",
"job_board": {},
"job_board_link": {},
"requirements_summary": "<string>",
"visa_sponsored": true,
"company_data": {
"description_summary": "<string>",
"linkedin_link": "<string>",
"size_range": {
"min": 123,
"max": 123
},
"industries": [
"<string>"
],
"subindustries": [
"<string>"
]
},
"company_slug": "<string>",
"job_slug": "<string>",
"expired": true,
"locations": [
{
"city": "<string>",
"region": "<string>",
"country": "<string>"
}
]
}
]
}Retrieve a single company profile — and a sample of its open job listings — by passing the
company_slug in the URL path. Use this endpoint to build company detail pages, enrich job search results with company context, or link out to company-specific views in your UI.
Endpoint
GET /v2/hirebase/companies/:company_slug
Path Parameters
Unique identifier for the target company. Passed directly in the URL path — do not send it in the request body (this is a
GET request).Authentication
Your Hirebase API key. Optional — not enforced on this endpoint today.
Response
Details of the company.
Show child attributes
Show child attributes
Unique identifier for the company (used in URL paths).
Name of the company.
URL to the company’s logo.
Name of the job board the company uses, if available.
URL to the company’s LinkedIn page.
URL to the company’s official website.
Short description of the company.
High-level industry tags associated with the company.
More specific industry categories.
Short culture / workplace summary.
Products or services the company offers.
Internal prominence / visibility signal.
Structured HQ location (
city, region, country, address, coordinates, bbox).Year the company was founded.
Public/private stock metadata (
stock_type, index, symbol).Funding summary (
type, total_rounds, last_funding_round, total_funding).Categorical company type (e.g.,
"Startup", "Enterprise").Whether the company is a third-party agency.
Whether the company is a recruiting/talent agency.
Mean opinion score (1–10).
Alternate company names.
Parent company name, when known.
Known subsidiary company names.
List of active jobs for the company
Show child attributes
Show child attributes
Unique job identifier
Name of the company
Title of the job
Full job description in HTML format
URL to apply for the job
Raw location string from the source
Categories this job belongs to
Type of job (e.g., “Full Time”)
Work setup (e.g., “In-Person”, “Remote”, “Hybrid”)
ISO date string representing when the job was posted
Job board name, if available
URL to the job board page
Brief summary of key job requirements
Indicates whether visa sponsorship is offered
Redundant company information provided for job context.
Show child attributes
Show child attributes
Short description of the company’s mission or services
URL to the company’s LinkedIn profile
List of high-level industry categories the company belongs to
More specific subcategories under the industries
Slug linking the job to its company
URL-friendly job identifier
Indicates whether the job is expired
Example Request
curl -X GET "https://api.hirebase.org/v2/hirebase/companies/anthropic" \
-H "x-api-key: YOUR_API_KEY"
Example Response
{
"company": {
"company_name": "CompanyXYZ",
"company_slug": "companyxyz",
"description_summary": "CompanyXYZ builds …",
"culture_summary": "Remote-first, high-autonomy engineering culture.",
"linkedin_link": "https://www.linkedin.com/company/companyxyz",
"company_link": "https://www.companyxyz.com",
"company_logo": "https://logos.hirebase.org/.../companyxyz.jpg",
"job_board": null,
"services": ["Platform", "APIs"],
"industries": ["Tech, Software & IT Services"],
"subindustries": ["AI & ML"],
"size_range": {"min": 201, "max": 500},
"clout": 87.4,
"headquarters": {
"city": "San Francisco",
"region": "California",
"country": "United States",
"address": "San Francisco, CA",
"coordinates": {"type": "Point", "coordinates": [-122.4, 37.77]},
"bbox": null
},
"founded": 2019,
"stock_info": {"stock_type": "private", "index": null, "symbol": null},
"funding_info": {"type": "Series C", "total_rounds": 5, "last_funding_round": "Series C", "total_funding": "750M"},
"type": "Startup",
"is_3rd_party_agency": false,
"is_recruiting_agency": false,
"mean_opinion_score": 7.0,
"aliases": ["Company XYZ Inc."],
"parent_company": null,
"subsidiaries": []
},
"jobs": [
{
"_id": "66ccecd72a2001139e9ecf62",
"company_name": "CompanyXYZ",
"job_title": "Didn't See What You Are Looking For?",
"description": "<p>CompanyXYZ is a platform where neighbors connect to build real-world connections. As a Software Engineer, you'll join a team passionate about using technology to cultivate a kinder world.</p><h2>Requirements</h2><ul><li>Ability to learn from coworkers and teach them</li><li>Experience working in multiple languages and services</li><li>Strong focus on quality and reliability</li></ul>",
"application_link": "https://about.companyxyz.com/careers-list/?gh_jid=2387416",
"location_raw": "San Francisco, CA",
"job_categories": [
"Software Engineer Jobs"
],
"job_type": "Full Time",
"location_type": "In-Person",
"yoe_range": null,
"salary_range": null,
"date_posted": "2024-07-08",
"company_link": "about.companyxyz.com",
"company_logo": "https://recruiting.cdn.greenhouse.io/external_greenhouse_job_boards/logos/000/100/123/resized/CompanyXYZ_logo_badge-circle_RGB.png?1613798682",
"job_board": "Greenhouse",
"job_board_link": "https://job-boards.greenhouse.io/companyxyz",
"requirements_summary": "Ability to learn, experience in multiple languages, strong focus on quality",
"visa_sponsored": false,
"company_data": null,
"company_slug": "companyxyz",
"job_slug": "didn-t-see-what-you-are-looking-for",
"expired": false,
"locations": [
{
"city": "San Francisco",
"region": "California",
"country": "United States"
}
]
}
]
}
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.
⌘I