Search Companies

curl --request POST \
  --url https://api.hirebase.org/v2/hirebase/companies/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "query": "<string>",
  "company_name": "<string>",
  "industries": [
    "<string>"
  ],
  "subindustries": [
    "<string>"
  ],
  "company_types": [
    "<string>"
  ],
  "types": [
    "<string>"
  ],
  "hq_geolocations": [
    {
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    }
  ],
  "linkedin_link": "<string>",
  "keywords": [
    "<string>"
  ],
  "hide_recruiter_agencies": true,
  "is_recruiting_agency": true,
  "is_3rd_party_agency": true,
  "funding_types": [
    "<string>"
  ],
  "parent_company": "<string>",
  "company_link": "<string>",
  "sort_by": "<string>",
  "sort_order": "<string>",
  "page": 123,
  "limit": 123
}
'

import requests

url = "https://api.hirebase.org/v2/hirebase/companies/search"

payload = {
    "query": "<string>",
    "company_name": "<string>",
    "industries": ["<string>"],
    "subindustries": ["<string>"],
    "company_types": ["<string>"],
    "types": ["<string>"],
    "hq_geolocations": [
        {
            "city": "<string>",
            "region": "<string>",
            "country": "<string>"
        }
    ],
    "linkedin_link": "<string>",
    "keywords": ["<string>"],
    "hide_recruiter_agencies": True,
    "is_recruiting_agency": True,
    "is_3rd_party_agency": True,
    "funding_types": ["<string>"],
    "parent_company": "<string>",
    "company_link": "<string>",
    "sort_by": "<string>",
    "sort_order": "<string>",
    "page": 123,
    "limit": 123
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    company_name: '<string>',
    industries: ['<string>'],
    subindustries: ['<string>'],
    company_types: ['<string>'],
    types: ['<string>'],
    hq_geolocations: [{city: '<string>', region: '<string>', country: '<string>'}],
    linkedin_link: '<string>',
    keywords: ['<string>'],
    hide_recruiter_agencies: true,
    is_recruiting_agency: true,
    is_3rd_party_agency: true,
    funding_types: ['<string>'],
    parent_company: '<string>',
    company_link: '<string>',
    sort_by: '<string>',
    sort_order: '<string>',
    page: 123,
    limit: 123
  })
};

fetch('https://api.hirebase.org/v2/hirebase/companies/search', 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/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'company_name' => '<string>',
    'industries' => [
        '<string>'
    ],
    'subindustries' => [
        '<string>'
    ],
    'company_types' => [
        '<string>'
    ],
    'types' => [
        '<string>'
    ],
    'hq_geolocations' => [
        [
                'city' => '<string>',
                'region' => '<string>',
                'country' => '<string>'
        ]
    ],
    'linkedin_link' => '<string>',
    'keywords' => [
        '<string>'
    ],
    'hide_recruiter_agencies' => true,
    'is_recruiting_agency' => true,
    'is_3rd_party_agency' => true,
    'funding_types' => [
        '<string>'
    ],
    'parent_company' => '<string>',
    'company_link' => '<string>',
    'sort_by' => '<string>',
    'sort_order' => '<string>',
    'page' => 123,
    'limit' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hirebase.org/v2/hirebase/companies/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"company_name\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"subindustries\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"types\": [\n    \"<string>\"\n  ],\n  \"hq_geolocations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"linkedin_link\": \"<string>\",\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"hide_recruiter_agencies\": true,\n  \"is_recruiting_agency\": true,\n  \"is_3rd_party_agency\": true,\n  \"funding_types\": [\n    \"<string>\"\n  ],\n  \"parent_company\": \"<string>\",\n  \"company_link\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hirebase.org/v2/hirebase/companies/search")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"company_name\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"subindustries\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"types\": [\n    \"<string>\"\n  ],\n  \"hq_geolocations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"linkedin_link\": \"<string>\",\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"hide_recruiter_agencies\": true,\n  \"is_recruiting_agency\": true,\n  \"is_3rd_party_agency\": true,\n  \"funding_types\": [\n    \"<string>\"\n  ],\n  \"parent_company\": \"<string>\",\n  \"company_link\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/hirebase/companies/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"company_name\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"subindustries\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"types\": [\n    \"<string>\"\n  ],\n  \"hq_geolocations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"linkedin_link\": \"<string>\",\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"hide_recruiter_agencies\": true,\n  \"is_recruiting_agency\": true,\n  \"is_3rd_party_agency\": true,\n  \"funding_types\": [\n    \"<string>\"\n  ],\n  \"parent_company\": \"<string>\",\n  \"company_link\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "companies": {
    "company_name": "<string>",
    "company_slug": "<string>",
    "description_summary": "<string>",
    "linkedin_link": {},
    "company_link": {},
    "culture_summary": {},
    "services": [
      "<string>"
    ],
    "size_range": {
      "min": 123,
      "max": 123
    },
    "industries": [
      "<string>"
    ],
    "subindustries": [
      "<string>"
    ],
    "company_logo": {},
    "clout": {},
    "headquarters": {},
    "founded": {},
    "stock_info": {},
    "funding_info": {},
    "type": {},
    "is_3rd_party_agency": {},
    "is_recruiting_agency": {},
    "mean_opinion_score": {},
    "aliases": [
      "<string>"
    ],
    "parent_company": {},
    "subsidiaries": [
      "<string>"
    ],
    "score": 123
  },
  "total_count": 123,
  "page": 123,
  "limit": 123,
  "total_pages": 123
}

POST

hirebase

companies

Search Companies

curl --request POST \
  --url https://api.hirebase.org/v2/hirebase/companies/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "query": "<string>",
  "company_name": "<string>",
  "industries": [
    "<string>"
  ],
  "subindustries": [
    "<string>"
  ],
  "company_types": [
    "<string>"
  ],
  "types": [
    "<string>"
  ],
  "hq_geolocations": [
    {
      "city": "<string>",
      "region": "<string>",
      "country": "<string>"
    }
  ],
  "linkedin_link": "<string>",
  "keywords": [
    "<string>"
  ],
  "hide_recruiter_agencies": true,
  "is_recruiting_agency": true,
  "is_3rd_party_agency": true,
  "funding_types": [
    "<string>"
  ],
  "parent_company": "<string>",
  "company_link": "<string>",
  "sort_by": "<string>",
  "sort_order": "<string>",
  "page": 123,
  "limit": 123
}
'

import requests

url = "https://api.hirebase.org/v2/hirebase/companies/search"

payload = {
    "query": "<string>",
    "company_name": "<string>",
    "industries": ["<string>"],
    "subindustries": ["<string>"],
    "company_types": ["<string>"],
    "types": ["<string>"],
    "hq_geolocations": [
        {
            "city": "<string>",
            "region": "<string>",
            "country": "<string>"
        }
    ],
    "linkedin_link": "<string>",
    "keywords": ["<string>"],
    "hide_recruiter_agencies": True,
    "is_recruiting_agency": True,
    "is_3rd_party_agency": True,
    "funding_types": ["<string>"],
    "parent_company": "<string>",
    "company_link": "<string>",
    "sort_by": "<string>",
    "sort_order": "<string>",
    "page": 123,
    "limit": 123
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: '<string>',
    company_name: '<string>',
    industries: ['<string>'],
    subindustries: ['<string>'],
    company_types: ['<string>'],
    types: ['<string>'],
    hq_geolocations: [{city: '<string>', region: '<string>', country: '<string>'}],
    linkedin_link: '<string>',
    keywords: ['<string>'],
    hide_recruiter_agencies: true,
    is_recruiting_agency: true,
    is_3rd_party_agency: true,
    funding_types: ['<string>'],
    parent_company: '<string>',
    company_link: '<string>',
    sort_by: '<string>',
    sort_order: '<string>',
    page: 123,
    limit: 123
  })
};

fetch('https://api.hirebase.org/v2/hirebase/companies/search', 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/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>',
    'company_name' => '<string>',
    'industries' => [
        '<string>'
    ],
    'subindustries' => [
        '<string>'
    ],
    'company_types' => [
        '<string>'
    ],
    'types' => [
        '<string>'
    ],
    'hq_geolocations' => [
        [
                'city' => '<string>',
                'region' => '<string>',
                'country' => '<string>'
        ]
    ],
    'linkedin_link' => '<string>',
    'keywords' => [
        '<string>'
    ],
    'hide_recruiter_agencies' => true,
    'is_recruiting_agency' => true,
    'is_3rd_party_agency' => true,
    'funding_types' => [
        '<string>'
    ],
    'parent_company' => '<string>',
    'company_link' => '<string>',
    'sort_by' => '<string>',
    'sort_order' => '<string>',
    'page' => 123,
    'limit' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hirebase.org/v2/hirebase/companies/search"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"company_name\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"subindustries\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"types\": [\n    \"<string>\"\n  ],\n  \"hq_geolocations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"linkedin_link\": \"<string>\",\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"hide_recruiter_agencies\": true,\n  \"is_recruiting_agency\": true,\n  \"is_3rd_party_agency\": true,\n  \"funding_types\": [\n    \"<string>\"\n  ],\n  \"parent_company\": \"<string>\",\n  \"company_link\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hirebase.org/v2/hirebase/companies/search")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"company_name\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"subindustries\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"types\": [\n    \"<string>\"\n  ],\n  \"hq_geolocations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"linkedin_link\": \"<string>\",\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"hide_recruiter_agencies\": true,\n  \"is_recruiting_agency\": true,\n  \"is_3rd_party_agency\": true,\n  \"funding_types\": [\n    \"<string>\"\n  ],\n  \"parent_company\": \"<string>\",\n  \"company_link\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hirebase.org/v2/hirebase/companies/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"company_name\": \"<string>\",\n  \"industries\": [\n    \"<string>\"\n  ],\n  \"subindustries\": [\n    \"<string>\"\n  ],\n  \"company_types\": [\n    \"<string>\"\n  ],\n  \"types\": [\n    \"<string>\"\n  ],\n  \"hq_geolocations\": [\n    {\n      \"city\": \"<string>\",\n      \"region\": \"<string>\",\n      \"country\": \"<string>\"\n    }\n  ],\n  \"linkedin_link\": \"<string>\",\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"hide_recruiter_agencies\": true,\n  \"is_recruiting_agency\": true,\n  \"is_3rd_party_agency\": true,\n  \"funding_types\": [\n    \"<string>\"\n  ],\n  \"parent_company\": \"<string>\",\n  \"company_link\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"sort_order\": \"<string>\",\n  \"page\": 123,\n  \"limit\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "companies": {
    "company_name": "<string>",
    "company_slug": "<string>",
    "description_summary": "<string>",
    "linkedin_link": {},
    "company_link": {},
    "culture_summary": {},
    "services": [
      "<string>"
    ],
    "size_range": {
      "min": 123,
      "max": 123
    },
    "industries": [
      "<string>"
    ],
    "subindustries": [
      "<string>"
    ],
    "company_logo": {},
    "clout": {},
    "headquarters": {},
    "founded": {},
    "stock_info": {},
    "funding_info": {},
    "type": {},
    "is_3rd_party_agency": {},
    "is_recruiting_agency": {},
    "mean_opinion_score": {},
    "aliases": [
      "<string>"
    ],
    "parent_company": {},
    "subsidiaries": [
      "<string>"
    ],
    "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.

Metering: company search bills m_company_api_calls at 1 unit per company returned (a limit: 50 search returning 50 companies costs 50 units). See Usage Headers & Metering.

Endpoint

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

Authentication

string

required

Your Hirebase API key. Authentication required — every request, including page 1, requires an API key in the x-api-key header. Requests without a key return 401. See Authentication.

Request Body

All fields are optional and can be combined freely.

string

Full-text search across company name, description, products/services, tech stack, and culture keywords (e.g., “Agentic Coding”, “climate tech”, “remote-first”).

string

Exact or partial company name match.

string[]

Filter by primary industry (e.g., ["Tech, Software & IT Services", "Healthcare"]). See List Industries for accepted values.

string[]

Narrow by subindustry (e.g., ["Medical Practices", "Blockchain"]).

string[]

Filter by company headcount bucket (maps to size_range). Accepted values: "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10000+".

string[]

Categorical company classification. Accepted values: "Startup", "Enterprise", "Mid-Size", "Small Business", "Non-Profit", "Government", "Franchise", "Academic", "Other".

object[]

Filter by company headquarters. Array of { city, region, country } objects; multiple entries are OR’d.

Show child attributes

string

HQ city

string

HQ state, region, or province. Use the full region/state name (e.g., "California", not "CA").

string

HQ country

string

Exact LinkedIn company URL. Must start with https://www.linkedin.com/ or https://linkedin.com/.

string[]

Keyword match across company text. Distinct from query (which is full-text); pass an array of terms.

boolean

Exclude recruiting-agency companies from results.

boolean

Filter to (or by) recruiting agencies.

boolean

Filter by the third-party agency flag.

string[]

Filter by company funding stage/type. Pass one or more of the accepted values.

View all funding_types values

Pre seed · Seed · Angel · Convertible note · Equity crowdfunding · Series unknown · Series A · Series B · Series C · Series D · Series E · Series F · Series G · Series H · Corporate round · Private equity · Debt financing · Secondary market · Grant · Non equity assistance · Undisclosed · Post IPO equity · Post IPO debt · Post IPO secondaryTip: the Post IPO … values indicate companies that have gone public — useful as a proxy for public companies.

string

Filter by parent company.

string

Filter by company website URL.

string

default:"hottest"

Field to sort results by. Accepted values:

hottest (default) — with a text query (query, company_name or keywords), by search relevance, then clout; without one, by clout.
relevance — by search relevance, then clout.
clout — by clout, the prominence signal returned on each company.
rated — by mean_opinion_score.
size — by the top of the company’s size_range (largest first by default).
newest — by founded year (most recently founded first by default).

string

default:"desc"

Sort direction ("asc" or "desc"). Applies to size, newest, clout, and rated; hottest and relevance always run descending.

"asc" puts companies with a missing value first (for example no size_range or founded). Combine with a filter such as company_sizes if you want the smallest known companies rather than unknown ones.

Because total_count caps at 1001 (see response), the narrowing effect of these filters can be hard to observe on broad queries — but they are accepted and applied. Judge a filter by the returned rows (for example each company’s size_range), not by total_count.

Unknown parameters are rejected with a 422, never silently ignored. There is no min/max headcount filter — names such as size_range, size_min, size_max, or employee_count return a 422 pointing you to company_sizes and its accepted buckets.

integer

default:"1"

Page number (1-indexed).

integer

default:"10"

Results per page. Max: 100.

Response

array[object]

Matching company records.

Show Company Object

string

Full company name

string

URL-safe identifier

string

Short company overview

string | null

LinkedIn profile URL

string | null

Official company website URL

string | null

Short culture / workplace summary

string[]

Products or services the company offers

object | null

integer

Estimated employee minimum

integer

Estimated employee maximum

string[]

Primary industries

string[]

Detailed subindustries

string | null

Logo URL

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

float

Relevance score (higher = better match)

integer

Total matching companies. Capped at 1001 — broader queries report total_count: 1001 even when more companies match. Use narrower filters to reach specific records.

integer

Current page

integer

Results per page

integer

Total pages available. Capped at 1001 — broader queries report total_pages: 1001 even when more pages exist. Use narrower filters to reach specific records.

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": 20
  }'

curl -X POST "https://api.hirebase.org/v2/hirebase/companies/search" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "industries": ["Tech, Software & IT Services"],
    "types": ["Startup"],
    "limit": 20
  }'

{
  "company_name": "OpenAI",
  "industries": ["Tech, Software & IT Services"],
  "page": 1,
  "limit": 20
}

Example Response

{
  "companies": [
    {
      "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",
      "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": [],
      "score": 28.4
    }
  ],
  "total_count": 87,
  "page": 1,
  "limit": 20,
  "total_pages": 5
}

Error Responses

422 Unprocessable Entity

Validation failures, including any parameter the endpoint does not recognize. An unknown key returns "Extra inputs are not permitted"; a misnamed headcount filter returns a hint:

{
  "detail": [
    {
      "type": "value_error",
      "loc": ["body"],
      "msg": "Value error, Unknown parameter(s) ['size_range']: there is no min/max headcount filter. Use `company_sizes` with headcount buckets, e.g. [\"11-50\", \"51-200\"]. ...",
      "input": {"size_range": {"min": 10, "max": 200}}
    }
  ]
}

Other validation failures (e.g., limit above 100):

{
  "detail": [
    {
      "type": "value_error",
      "loc": ["body", "limit"],
      "msg": "Value error, Limit must be between 1 and 100",
      "input": 500
    }
  ]
}

400 Bad Request

Hand-rolled checks (e.g., unsafe strings). Note: a malformed or non-matching linkedin_link is not an error — it returns 200 with an empty companies array.

401 Unauthorized

Missing, invalid, or revoked API key.

429 Too Many Requests

Rate limit exceeded — 100 requests per 60 seconds per API key. 429 responses include a Retry-After header.

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.

Jobs API

Expired & Historical Jobs API

Hiring Manager API

Companies API

Insights API

Salary Benchmark API

Reference Data API

Resumes

Tasks API

Billing & Usage

Error Handling

Search Companies

Endpoint

Authentication

Request Body

Response

Example Requests

Example Response

Error Responses

​Endpoint

​Authentication

​Request Body

​Response

​Example Requests

​Example Response

​Error Responses

Endpoint

Authentication

Request Body

Response

Example Requests

Example Response

Error Responses