Jobs API
Reference Data API
Resume (Embeddings) API
Tasks API
Error Handling
Search Companies
curl --request POST \
--url https://api.hirebase.org/v2/hirebase/companies/search \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"company_name": "<string>",
"industries": [
"<string>"
],
"subindustries": [
"<string>"
],
"company_types": [
"<string>"
],
"job_board": "<string>",
"linkedin_link": "<string>",
"page": 123,
"limit": 123
}
'{
"companies": {
"company_name": "<string>",
"company_slug": "<string>",
"description_summary": "<string>",
"linkedin_link": {},
"job_board": "<string>",
"size_range": {
"min": 123,
"max": 123
},
"industries": [
"<string>"
],
"subindustries": [
"<string>"
],
"company_logo": {},
"score": 123
},
"total_count": 123,
"page": 123,
"limit": 123,
"total_pages": 123
}Companies API
Search Companies
Powerful full-text and filter-based company discovery with geographic proximity, recruiter filtering, and rich metadata.
POST
/
v2
/
hirebase
/
companies
/
search
Search Companies
curl --request POST \
--url https://api.hirebase.org/v2/hirebase/companies/search \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"company_name": "<string>",
"industries": [
"<string>"
],
"subindustries": [
"<string>"
],
"company_types": [
"<string>"
],
"job_board": "<string>",
"linkedin_link": "<string>",
"page": 123,
"limit": 123
}
'{
"companies": {
"company_name": "<string>",
"company_slug": "<string>",
"description_summary": "<string>",
"linkedin_link": {},
"job_board": "<string>",
"size_range": {
"min": 123,
"max": 123
},
"industries": [
"<string>"
],
"subindustries": [
"<string>"
],
"company_logo": {},
"score": 123
},
"total_count": 123,
"page": 123,
"limit": 123,
"total_pages": 123
}Search for companies using a combination of keyword/full-text search and precise filters. This endpoint powers both the Hirebase web app’s enhanced company explorer and the public Company Search API used by over 500 customers.Documentation Index
Fetch the complete documentation index at: https://www.hirebase.org/docs/llms.txt
Use this file to discover all available pages before exploring further.
Endpoint
POST https://api.hirebase.org/v2/hirebase/companies/search
Authentication
Your Hirebase API key. Not required for page 1 — include it on requests for page 2 and beyond.
Request Body
All fields are optional and can be combined freely.Full-text search across company name, description, products/services, tech stack, and culture keywords (e.g., “Agentic Coding”, “climate tech”, “remote-first”).
Exact or partial company name match.
Filter by primary industry (e.g.,
["Tech, Software & IT Services", "Healthcare"]). See List Industries for accepted values.Narrow by subindustry (e.g.,
["Medical Practices", "Blockchain"]).Company type tags such as
"Startup", "Public Company", "Non-Profit", etc.Source job board (e.g.,
"Greenhouse", "Lever", "Workable").Exact LinkedIn company URL. Must start with
https://www.linkedin.com/ or https://linkedin.com/.Page number (1-indexed).
Results per page. Max: 100.
Response
Matching company records.
Show Company Object
Show Company Object
Full company name
URL-safe identifier
Short company overview
LinkedIn profile URL
Primary job board used
Primary industries
Detailed subindustries
Logo URL
Relevance score (higher = better match)
Total matching companies
Current page
Results per page
Total pages available
Example Requests
curl -X POST "https://api.hirebase.org/v2/hirebase/companies/search" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"query": "ai infrastructure",
"industries": ["Tech, Software & IT Services"],
"limit": 10
}'
Example Response
{
"companies": [
{
"company_name": "Anthropic",
"company_slug": "anthropic",
"description_summary": "Anthropic is an AI safety and research company working on reliable, interpretable, and steerable AI systems.",
"linkedin_link": "https://www.linkedin.com/company/anthropicresearch/",
"job_board": "Lever",
"size_range": { "min": 201, "max": 500 },
"industries": ["Tech, Software & IT Services"],
"subindustries": ["AI & ML"],
"company_logo": "https://assets.anthropic.com/m/...",
"score": 28.4
}
],
"total_count": 87,
"page": 1,
"limit": 20,
"total_pages": 5
}
Error Responses
400 Bad Request
400 Bad Request
Invalid parameters (e.g.,
limit > 100, malformed LinkedIn URL, unsafe strings).401 Unauthorized
401 Unauthorized
Missing, invalid, or revoked API key.
429 Too Many Requests
429 Too Many Requests
Rate limit exceeded (4 req/sec on search endpoints).
500 Internal Server Error
500 Internal Server Error
Unexpected server issue – please contact support.
Pro Tip: Combine
query with industries for hyper-relevant discovery — e.g., find “climate tech” companies hiring within Agriculture.This endpoint reflects Hirebase 2.2 enhancements: smarter geo-proximity, recruiter noise filtering, and rich keyword understanding across company descriptions and tech stacks.
⌘I