Skip to main content
Huntr gives you an agent (/research) and deterministic endpoints (search, enrichment, pages). Both use the same API key and credit balance.

​
Research agent (POST /research)

Best for: open-ended questions where you want Huntr to decide which sources to check and how to combine them. 
Prompt in → investigation → synthesized answer out
Strengths
  • One call for account briefs, buyer research, competitive questions
  • Optional schema for structured top-level fields
  • Tiers (lite, standard, deep) control capability depth
Limits
  • One primary target per request
  • Not for bulk list + per-row enrichment
  • Price is per completed research run (see /pricing for current tiers)

​
Research tiers

TierTypical use
litePublic-web research — search, news, pages
standardCompany research + tech, contact, and page enrichment
deepPeople and contact research — profiles, email finding, LinkedIn

​
Direct endpoints

Best for: repeatable workflows where your code (or Clay column) already knows the operation.
FamilyExamplesBilling
List building/company-search, /person-searchPer row returned; count endpoints free
Company enrichment/company-linkedin, /company-tech-stack, /company-jobs, /company-contactPer request; some free when no data found
Person enrichment/person-email, /person-linkedin, /person-linkedin-urlPer request
Page enrichment/page-find, /page-scrape, /page-analyzePer request
Strengths
  • Predictable inputs and outputs
  • Lower cost for single-purpose lookups
  • Easy to chain in automations (search → enrich → email)

​
Cost intuition

TaskPrefer
”What should we say to Stripe about fraud partnerships?”/research
”Get stripe.com’s tech stack”/company-tech-stack
”Find the CEO email at notion.so”/person-email or /research tier deep
”500 SaaS companies in the US with 50–200 employees”/company-search
When in doubt: if you can name the endpoint, call it directly. If you need judgment and synthesis, use /research.

​
MCP exposes the full API

The Huntr MCP server mirrors every REST endpoint as a tool — not just research:
  • Research: research
  • List building: company_search, company_search_count, person_search, person_search_count
  • Enrichment: person_email, person_linkedin, tech_stack, job_postings, company_contact, and more
  • Pages: find_pages, page_scrape, page_analyze
  • Meta (free): get_pricing, get_balance, get_usage
Agents should call direct tools for known lookups and research for open-ended synthesis on one target. See the full tool list.

​
Next step