Developers

HuntSales API

A REST API (and an MCP server for AI agents) over the same verified APAC contact data and credit system as the app. Search people, collect their details, and check your balance from your own tools.

Authentication

Create a key in Settings → Billing → API keys (shown once, copy it then). Send it as a bearer token. Base URL: https://huntsales.io/api/v1.

curl https://huntsales.io/api/v1/credits \
  -H "Authorization: Bearer hs_live_xxxxxxxxxxxx"

Scopes & credit costs

Each key carries scopes. API calls draw down the same credits as in-app Live (1 credit = S$0.05 retail):

Action	Scope	Credits
People search (per page)	`people:search`	1
Collect (per person)	`people:collect`	1 + 1/email + 7/phone
Credit balance	`credits:read`	free

A 402 is returned when your balance can't cover the call. Every response includes credits_remaining.

get/api/v1/credits

Returns your org's HuntSales credit balance.

Scope: credits:read · Cost: free

{ "balance": 1240, "plan_remaining": 1000, "topup_balance": 240 }

post/api/v1/people/search

Search verified contacts. Returns preview rows; email/phone are revealed by collect.

Scope: people:search · Cost: 1 credit

curl -X POST https://huntsales.io/api/v1/people/search \
  -H "Authorization: Bearer hs_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "job_title": ["founder","ceo"], "country_list": ["Singapore"], "page": 1 }'

{ "results": [ { "people_id": "...", "full_name": "...", "experience": [...] } ],
  "total_results": 482, "credits_remaining": 1239, "credits_charged": 1 }

post/api/v1/people/collect

Reveal email and/or phone for selected people_ids (max 50).

Scope: people:collect · Cost: 1 + 1/email + 7/phone

curl -X POST https://huntsales.io/api/v1/people/collect \
  -H "Authorization: Bearer hs_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "people_ids": ["..."], "reveal_email": true, "reveal_phone": false }'

{ "results": [ { "people_id": "...", "experience": [ { "work_email": "...", "contact_number": null } ] } ],
  "credits_remaining": 1238, "credits_charged": 2 }

MCP (connect your AI)

HuntSales ships an MCP server so AI agents (Claude, etc.) can search and collect contacts using your API key. Add it to your MCP client config:

{
  "mcpServers": {
    "huntsales": {
      "command": "npx",
      "args": ["-y", "@huntsales/mcp"],
      "env": { "HUNTSALES_API_KEY": "hs_live_xxxxxxxxxxxx" }
    }
  }
}

Tools: people_search, people_collect, get_credits. Same scopes + credit costs as REST.

Rate limits and webhooks are rolling out. Questions? Contact support from your dashboard.