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>"
  ],
  "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 = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'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"
  ],
]);

$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("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("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["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' \
  --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 = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'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"
  ],
]);

$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("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("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["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.

Endpoint

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

Authentication

x-api-key

string

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.

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., ["Tech, Software & IT Services", "Healthcare"]). See List Industries for accepted values.

subindustries

string[]

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

company_types

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+".

types

string[]

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

hq_geolocations

object[]

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

Show child attributes

city

string

HQ city

region

string

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

country

string

HQ country

linkedin_link

string

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

keywords

string[]

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

hide_recruiter_agencies

boolean

Exclude recruiting-agency companies from results.

is_recruiting_agency

boolean

Filter to (or by) recruiting agencies.

is_3rd_party_agency

boolean

Filter by the third-party agency flag.

funding_types

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.

parent_company

string

Filter by parent company.

company_link

string

Filter by company website URL.

sort_by

string

Field to sort results by.

⚠️ Not currently applied — accepted but does not reorder results yet.

sort_order

string

Sort direction ("asc" or "desc").

⚠️ Not currently applied — accepted but does not reorder results yet.

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.

page

integer

default:"1"

Page number (1-indexed).

limit

integer

default:"10"

Results per page. Max: 100.

Response

companies

array[object]

Matching company records.

Show Company Object

company_name

string

Full company name

company_slug

string

URL-safe identifier

description_summary

string

Short company overview

linkedin_link

string | null

LinkedIn profile URL

company_link

string | null

Official company website URL

culture_summary

string | null

Short culture / workplace summary

services

string[]

Products or services the company offers

size_range

object | null

min

integer

Estimated employee minimum

max

integer

Estimated employee maximum

industries

string[]

Primary industries

subindustries

string[]

Detailed subindustries

company_logo

string | null

Logo URL

clout

number | null

Internal prominence / visibility signal

headquarters

object | null

Structured HQ location (city, region, country, address, coordinates, bbox)

founded

integer | null

Year the company was founded

stock_info

object | null

Public/private stock metadata (stock_type, index, symbol)

funding_info

object | null

Funding summary (type, total_rounds, last_funding_round, total_funding)

type

string | null

Categorical company type (e.g., "Startup", "Enterprise")

is_3rd_party_agency

boolean | null

Whether the company is a third-party agency

is_recruiting_agency

boolean | null

Whether the company is a recruiting/talent agency

mean_opinion_score

number | null

Mean opinion score (1–10)

aliases

string[]

Alternate company names

parent_company

string | null

Parent company name, when known

subsidiaries

string[]

Known subsidiary company names

score

float

Relevance score (higher = better match)

total_count

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.

page

integer

Current page

limit

integer

Results per page

total_pages

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 (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 (4 req/sec on search endpoints).

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.

Hiring Manager Contacts API

Get Company

Jobs API

Hiring Manager API

Companies API

Insights API

Reference Data API

Resumes

Tasks API

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