Skip to main content
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>",
  "company_slug": "<string>",
  "filters": {
    "filters.industry": [
      "<string>"
    ],
    "filters.location": [
      "<string>"
    ],
    "filters.size": [
      "<string>"
    ],
    "filters.founded_after": "<string>",
    "filters.founded_before": "<string>"
  },
  "geo_locations": [
    {
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    }
  ],
  "industries": [
    "<string>"
  ],
  "subindustries": [
    "<string>"
  ],
  "job_board": "<string>",
  "score": 123,
  "sort_by": "<string>",
  "sort_order": "<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": [
        {}
      ],
      "subindustries": [
        {}
      ],
      "company_logo": {},
      "score": 123
    }
  ],
  "total_count": 123,
  "page": 123,
  "limit": 123,
  "total_pages": 123
}
Search for companies using common filters such as name, industry, location, employee, etc. This API endpoint supports both usual filters and full-text based keyword search, making it useful for exploring specific companies or discovering new ones.

​
Endpoint

POST /v2/hirebase/companies/search

​
Request Body

Note:
  • All request body fields are optional.
  • Filter combinations can be mixed and matched.
  • Use specific filters to narrow down search results and get relevant matches.
​
query
string
Search query string used to find matching companies.
​
company_name
string
Filter by the name of the company offering the job.
​
company_slug
string
Filter jobs by the unique company slug identifier.
​
filters
object
Filtering parameters for refining company search
​
geo_locations
object[]
Array of location objects with city, region, and country (alternate to using filters.location)
​
industries
string[]
Direct list of industries (alternate to using filters.industry)
​
subindustries
string[]
Direct list of subindustries for finer filtering
​
job_board
string
Name of the job board from which the jobs were sourced (e.g., “Greenhouse”)
​
score
float
Minimum similarity score to include in results
Note:Higher similarity scores indicate stronger semantic matches.
​
sort_by
string
Field to sort results by (e.g., “founded after”, “size”, etc.)
​
sort_order
string
Sort direction (“asc” or “desc”)
​
page
number
Page number for pagination (default: 1)
​
limit
number
Number of results per page (default: 10)
Note:The pagination (page and limit) fields control the number of results displayed.

​
Response

​
companies
array
List of companies matching the search criteria
​
total_count
integer
Total number of matching companies found
​
page
integer
Current page number in the response
​
limit
integer
Number of companies returned in the current page
​
total_pages
integer
Total number of pages based on result count and pagination limit

​
Example Request

curl -X POST "https://api.hirebase.org/v2/hirebase/companies/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "industry": ["Healthcare"],
      "location": ["New York City", "New York"],
      "size": ["1-10", "11-50"],
      "founded_after": "1998-01-01"
    },
    "page": 1,
    "limit": 10,
    "sort_by": "founded_date",
    "sort_order": "desc"
  }'

​
Example Response

{
    "companies": [
        {
            "company_name": "CompanyXYZ",
            "company_slug": "companyxyz",
            "description_summary": "CompanyXYZ combines technology with evidence-based care to improve pregnancy and newborn outcomes for families.",
            "linkedin_link": null,
            "job_board": "Greenhouse",
            "size_range": {
                "min": 51,
                "max": 200
            },
            "industries": [
                "Healthcare"
            ],
            "subindustries": [
                "Medical Practices",
                "Healthcare Technology"
            ],
            "company_logo": "https://s4-recruiting.cdn.greenhouse.io/external_greenhouse_job_boards/logos/400/711/000/resized/CompanyXYZ-Logo-Transparent_Bean.png?2109796438",
            "score": 15.982008934020996
        },
        {
            "company_name": "CompanyABC",
            "company_slug": "companyabc",
            "description_summary": "CompanyABC partners with practices to improve cancer care via technology and patient focus.",
            "linkedin_link": null,
            "job_board": "Greenhouse",
            "size_range": null,
            "industries": [
                "Healthcare"
            ],
            "subindustries": [
                "Medical Practices",
                "Healthcare Technology"
            ],
            "company_logo": null,
            "score": 15.982008934020996
        },
        {
            "company_name": "DermaCompamy",
            "company_slug": "dermacompany",
            "description_summary": "DermaCompany offers comprehensive dermatology services, striving for the ultimate patient and employee experience.",
            "linkedin_link": null,
            "job_board": "Greenhouse",
            "size_range": null,
            "industries": [
                "Healthcare"
            ],
            "subindustries": [
                "Medical Practices"
            ],
            "company_logo": "https://s2-recruiting.cdn.greenhouse.io/external_greenhouse_job_boards/logos/400/287/020/resized/schweiger_logo_1.png?1539783876",
            "score": 15.454713821411133
        }
    ],
    "total_count": 285,
    "page": 1,
    "limit": 3,
    "total_pages": 95
}

​
Error Responses

Returns when the request is missing required data or includes invalid parameters.
Returns when the API key is missing, invalid, or incorrect.
Returns when an unexpected error occurs on the server.
  • Occurs during unhandled server-side failures or bugs that prevent the request from being processed.