Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.moltsets.com/llms.txt

Use this file to discover all available pages before exploring further.

MoltSets is an identity resolution API. You give it a piece of data — an email address, LinkedIn URL, IP address, or hashed email — and it returns enriched contact and company information. Every tool follows the same request and response structure, so once you’ve made one call, you know how to make all of them.

Base URL

All API requests go to:
https://api.moltsets.com/api/v1/tools/
Each tool has its own endpoint path. For example:
POST https://api.moltsets.com/api/v1/tools/enrich_email
POST https://api.moltsets.com/api/v1/tools/ip_to_company
POST https://api.moltsets.com/api/v1/tools/get_account

How a request works

Every request is a POST with a JSON body, an Authorization header, and a Content-Type header:
curl -X POST https://api.moltsets.com/api/v1/tools/enrich_email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedin_url": "https://linkedin.com/in/retentionadam"}'

How a response works

All responses return HTTP 200 with a consistent envelope:
{
  "results": { ... },
  "status": "ok",
  "metadata": {
    "tokens_charged": 1,
    "tokens_remaining": 206
  }
}
  • results — the data returned by the tool. Empty object {} or empty array [] when no data is found.
  • status — always "ok" on a successful request, even when no data is found.
  • metadata.tokens_charged — credits consumed. Always 0 when no data is returned.
  • metadata.tokens_remaining — your remaining credit balance after this request.

Credits

MoltSets uses credit-based billing. Credits are only consumed when a tool returns data — you are never charged for an empty result.
PlanCreditsPrice
Free250 / month$0
Starter3,000 / month$149 / month
Growth10,000 / month$299 / month
UnlimitedUnlimited$499 / month
Use get_billing to check credit costs per tool, and get_usage to see your consumption breakdown.

Available tools

CategoryTools
Accountget_account, get_billing, get_usage
Emailenrich_email, enrich_personal_email, linkedin_to_best_personal_email, hem_to_email, business_email_to_personal_hem
LinkedInlinkedin_slug_search, linkedin_to_hashed_emails, linkedin_to_business_profile
Phoneenrich_phone
HEM Resolutionhem_to_linkedin, hem_to_best_linkedin, hem_to_business_profile, hem_to_maid
IP Resolutionip_to_hem, ip_to_maid, ip_to_company

What to do next

Authentication

Get your API key and learn how to authenticate requests.

Rate Limits

Understand the limits that apply to all plans.