Search Companies

Search for companies with filters for location and company size.

1 credit

Authentication required

Parameters

Name	Type	Required	Description
keywords	string	Required	Search keywords (e.g., 'tech startup')
start	integer	Optional	Pagination offsetDefault: `0`
count	integer	Optional	Results per page (max 50)Default: `10`
location	string	Optional	Geo URN ID (e.g., '103644278' for USA)
company_size	string	Optional	Size codes: A (self-employed), B (1-10), C (11-50), D (51-200), E (201-500), F (501-1000), G (1001-5000), H (5001-10000), I (10001+)

Response Example

{
  "results": [
    {
      "company_id": "1441",
      "universal_name": "google",
      "linkedin_url": "https://www.linkedin.com/company/google/",
      "name": "Google",
      "industry": "Software Development",
      "location": "Mountain View, CA",
      "followers": "40M followers",
      "insight": "5 connections work here"
    }
  ],
  "pagination": {
    "total_results": 3803,
    "start": 0,
    "count": 5,
    "has_more": true
  }
}

Try it out

API Key

No API keys found. Create a key to use the playground.

Parameters

keywordsrequired

Search keywords (e.g., 'tech startup')

start

Pagination offset

count

Results per page (max 50)

location

Geo URN ID (e.g., '103644278' for USA)

company_size

Size codes: A (self-employed), B (1-10), C (11-50), D (51-200), E (201-500), F (501-1000), G (1001-5000), H (5001-10000), I (10001+)

Code Examples

curl -X GET "https://api.heyscraper.io/api/company/search?keywords=%3Ckeywords%3E" \
  -H "X-API-Key: hs_live_your_api_key"