Skip to main content

Available Company Endpoints

Hirebase offers two main endpoints for accessing company data:
  1. POST /v2/hirebase/companies/search - Search for companies by various criteria
  2. GET /v2/hirebase/companies/:company_slug - Retrieve a record for a Company

Get Company

Retrieve a single company profile (plus a sample job listing) by its slug:

Response Structure

Get Company Jobs

The GET endpoint allows you to retrieve companies with basic pagination:

Response Structure

Searching Companies

The search endpoint provides more powerful filtering options:

Search Parameters

  • query: General search term matching company descriptions
  • company_name: Filter by specific company name
  • hq_geolocations: Array of HQ location objects with city, region, and country (OR across entries)
  • industries: Array of industry categories
  • subindustries: Array of more specific industry categories
  • company_types: Headcount buckets (e.g., "1-10", "51-200")
  • types: Categorical labels (e.g., "Startup", "Enterprise", "Non-Profit")
  • page: Page number for pagination
  • limit: Number of results per page

Use Cases for Company Data

Finding Companies in a Specific Industry

Company Profile Enrichment

Once you have a company’s data, you can use it to enhance job listings or build company profiles in your application and search through their jobs.

Next Steps