Find companies by who they sell to
Build a list of companies from a plain-language ICP, then narrow it with filters.
Goal: US vendors of practice management software for independent dental practices, 11–200 employees.
Count (free)
curl https://api.companyspec.com/v1/companies/count \
-H "Authorization: Bearer $COMPANYSPEC_API_KEY" -H "Content-Type: application/json" \
-d '{
"semantic_query": "practice management software for independent dental practices",
"countries": ["US"],
"employees": ["11-50", "51-200"],
"min_score": 0.6
}'{ "total": 57, "total_capped": false, "would_charge": 57 }Pass the same min_score you'll use in the search, so the count matches what you'll pay for.
Narrow if needed
Add filters until the list is the right size. For example, only companies that list HIPAA and are hiring in sales:
{ "compliance": ["HIPAA"], "hiring": { "job_functions": ["sales"] } }Add "group_by": ["customer_segments"] to the count to see how the matches split. Up to 3 fields; see
Count companies for the list.
Pull the results
curl https://api.companyspec.com/v1/companies/search \
-H "Authorization: Bearer $COMPANYSPEC_API_KEY" -H "Content-Type: application/json" \
-d '{
"semantic_query": "practice management software for independent dental practices",
"countries": ["US"],
"employees": ["11-50", "51-200"],
"min_score": 0.6,
"limit": 50
}'Results are sorted by match.score, highest first. You pay 1 discovery per company returned, once per billing
month. With 57 matches and limit: 50, pass the next_cursor from the response as cursor to get the last 7.
Read the details (free for the rest of the billing month)
Every company in the results is now paid for this billing month, so everything else about it is free until the
month ends: its profile with ICP (show_icp=true) and pricing summary (show_pricing=true), page summaries, technologies,
headcount, recent hires, funding, news and job postings.