Discover companies by query, industry, technology, headcount, and location via Hunter.io's MPP-wrapped API.
What it does
The Hunter Discover Companies endpoint (`/hunter/discover`) lets agents search for companies using free-text queries, organization names, or similarity to a given domain. Results can be filtered by headquarters location, industry, employee headcount range, company type (public/private/nonprofit), keywords, and technology stack. Pagination is supported via limit and offset parameters.
This endpoint is part of a broader Hunter.io suite exposed through the Locus MPP (Micropayment Protocol) gateway, which also includes domain search, email finder, email verifier, email enrichment, company enrichment, combined enrichment, and email count endpoints. Payment is per-call (intent: charge) settled via Tempo in pathUSD. The Discover Companies endpoint costs 8,000 base units; given pathUSD uses 6 decimals, that equates to $0.008 per request. The endpoint accepts POST requests with a JSON body.
Note that the probe returned 404 on HEAD and GET methods, which is expected since the OpenAPI spec defines this as a POST-only endpoint. The OpenAPI schema is well-defined with clear parameter descriptions, though response schemas are not documented beyond status codes. The upstream Hunter.io API documentation is referenced at https://hunter.io/api-documentation/v2 for full response format details.
Capabilities
Use cases
- —Finding companies in a specific industry and location for targeted outreach
- —Discovering companies similar to an existing customer for lookalike prospecting
- —Filtering companies by technology stack to identify potential buyers of complementary tools
- —Building lead lists segmented by headcount and company type
- —Enriching CRM data with company discovery queries
Fit
Best for
- —Sales and marketing teams building prospect lists programmatically
- —AI agents performing automated lead research and company discovery
- —Developers integrating company search into outreach automation pipelines
Not for
- —Individual email address lookup (use the email-finder or email-verifier endpoints instead)
- —Real-time company monitoring or change detection
- —Bulk data export of entire company databases
Quick start
curl -X POST https://hunter.mpp.paywithlocus.com/hunter/discover \
-H "Content-Type: application/json" \
-d '{"query": "fintech", "headquarters_location": "San Francisco", "headcount": "51-200", "limit": 5}'Example
Request
{
"limit": 10,
"query": "fintech",
"offset": 0,
"industry": "Financial Services",
"headcount": "51-200",
"technology": "react",
"company_type": "private",
"headquarters_location": "San Francisco"
}Endpoint
Quality
The OpenAPI spec provides a clear request schema with well-described parameters and pricing info, but response schemas are absent (only status codes documented). The probe returned 404 because HEAD/GET were used on a POST-only endpoint, so liveness is uncertain but plausible. No crawled pages returned useful content.
Warnings
- —Response schema is not documented; only status codes 200 and 402 are listed without body definitions.
- —Probe did not confirm liveness: 404 on HEAD/GET, but endpoint is POST-only per OpenAPI spec—actual POST liveness unverified.
- —pathUSD currency address (0x20c000000000000000000000b9537d11c60e8b50) and decimal count inferred as 6 decimals; not explicitly confirmed in probe data.
- —No example responses available from probe or crawl data.
Citations
- —The Discover Companies endpoint costs 8,000 base units in pathUSD via Tempo settlement.https://hunter.mpp.paywithlocus.com
- —Hunter.io API documentation is available at https://hunter.io/api-documentation/v2.https://hunter.mpp.paywithlocus.com
- —The endpoint accepts filters for query, organization, similar_to, headquarters_location, industry, headcount, company_type, keywords, technology, limit, and offset.https://hunter.mpp.paywithlocus.com
- —LLM-oriented docs referenced at https://beta.paywithlocus.com/mpp/hunter.md.https://hunter.mpp.paywithlocus.com