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
string
required
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
string
Your Hirebase API key. Optional — not enforced on this endpoint today.
Response
object
Details of the company.
Show child attributes
Show child attributes
string
Unique identifier for the company (used in URL paths).
string
Name of the company.
string
URL to the company’s logo.
string or null
Name of the job board the company uses, if available.
string
URL to the company’s LinkedIn page.
string
URL to the company’s official website.
string
Short description of the company.
object
string[]
High-level industry tags associated with the company.
string[]
More specific industry categories.
string | null
Short culture / workplace summary.
string[]
Products or services the company offers.
number | null
Internal prominence / visibility signal.
object | null
Structured HQ location (
city, region, country, address, coordinates, bbox).integer | null
Year the company was founded.
object | null
Public/private stock metadata (
stock_type, index, symbol).object | null
Funding summary (
type, total_rounds, last_funding_round, total_funding).string | null
Categorical company type (e.g.,
"Startup", "Enterprise").boolean | null
Whether the company is a third-party agency.
boolean | null
Whether the company is a recruiting/talent agency.
number | null
Mean opinion score (1–10).
string[]
Alternate company names.
string | null
Parent company name, when known.
string[]
Known subsidiary company names.
array
List of active jobs for the company
Show child attributes
Show child attributes
string
Unique job identifier
string
Name of the company
string
Title of the job
string
Full job description in HTML format
string
URL to apply for the job
string
Raw location string from the source
string[]
Categories this job belongs to
string
Type of job (e.g., “Full Time”)
string
Work setup (e.g., “In-Person”, “Remote”, “Hybrid”)
object
object or null
string
ISO date string representing when the job was posted
string or null
Job board name, if available
string or null
URL to the job board page
string
Brief summary of key job requirements
boolean
Indicates whether visa sponsorship is offered
object
Redundant company information provided for job context.
Show child attributes
Show child attributes
string
Short description of the company’s mission or services
string
URL to the company’s LinkedIn profile
object
string[]
List of high-level industry categories the company belongs to
string[]
More specific subcategories under the industries
string
Slug linking the job to its company
string
URL-friendly job identifier
boolean
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.