Skip to main content
POST
https://api.hirebase.org
/
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.

​
Endpoint

POST https://api.hirebase.org/v2/hirebase/companies/search

​
Authentication

Include your API key in the Authorization header: 
Authorization: Bearer YOUR_API_KEY

​
Request Body

All fields are optional and can be combined freely.
​
query
string
Full-text search across company name, description, products/services, tech stack, and culture keywords (e.g., “Agentic Coding”, “climate tech”, “remote-first”).
​
company_name
string
Exact or partial company name match.
​
industries
string[]
Filter by primary industry (e.g., ["Healthcare", "FinTech"]). See Industry List.
​
subindustries
string[]
Narrow by subindustry (e.g., ["Medical Practices", "Blockchain"]).
​
company_types
string[]
Company type tags such as "Startup", "Public Company", "Non-Profit", etc.
​
job_board
string
Source job board (e.g., "Greenhouse", "Lever", "Workable").
​
linkedin_link
string
Exact LinkedIn company URL. Must start with https://www.linkedin.com/ or https://linkedin.com/.
​
page
integer
default:"1"
Page number (1-indexed).
​
limit
integer
default:"10"
Results per page. Max: 100.

​
Response

​
companies
array[object]
Matching company records.
​
total_count
integer
Total matching companies
​
page
integer
Current page
​
limit
integer
Results per page
​
total_pages
integer
Total pages available

​
Example Requests

curl -X POST "https://api.hirebase.org/v2/hirebase/companies/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "AI agentic workflows",
    "page": 1,
    "limit": 20
  }'

​
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": ["Artificial Intelligence"],
      "subindustries": ["AI Research", "Large Language Models"],
      "company_logo": "https://assets.anthropic.com/m/...",
      "score": 28.4
    }
  ],
  "total_count": 87,
  "page": 1,
  "limit": 20,
  "total_pages": 5
}

​
Error Responses

Invalid parameters (e.g., limit > 100, malformed LinkedIn URL, unsafe strings).
Missing, invalid, or revoked API key.
Rate limit exceeded (4 req/sec on search endpoints).
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.