Search companies
Find companies in the Happierleads database by industry, size, location or technology, or look one up by name.
Authenticated with ?privateKey=YOUR_KEY (see Authentication).
| POST | /v3/prospector/companies/search | Search companies |
POST
/v3/prospector/companies/searchTry:
Request body
Website IdWebsite ID from list_websites. The search runs under this website.
QuerySearch filters as one flat object. Every field is optional; combine them to narrow the search.
KeywordsCompany name or domain keyword, e.g. "acme" or "acme.example".
IndustriesIndustry names, e.g. ["Marketing and Advertising", "Computer Software"].
Computer Software
LocationsCompany HQ countries by full name, e.g. ["United States", "Germany"]. Continents ("Europe", "Asia") are also accepted.
United States
Employees MinMinimum headcount (whole number). Applied to the real employee count.
Employees MaxMaximum headcount (whole number). Applied to the real employee count.
Revenue MinMinimum annual revenue (number). Defaults to 0.
Revenue MaxMaximum annual revenue (number).
TechnologiesTechnologies the company uses, e.g. ["HubSpot", "Shopify"].
PagePage number, starting at 1. Default 1.
CountResults per page. Default 25.
curl -X POST "https://rest-admin.happierleads.com/v3/prospector/companies/search?privateKey=YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9", "query": { "industries": [ "Computer Software" ], "locations": [ "United States" ] }}'Response
Press Send request to try it with sample data.
Use case: Companies using a technology
POST /v3/prospector/companies/search with "technologies": ["HubSpot"] in the query.