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

Field to sort results by.

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

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.

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 (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 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