Skip to main content
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:
Each tool has its own endpoint path. For example:

​
How a request works

Every request is a POST with a JSON body, an Authorization header, and a Content-Type header:

​
How a response works

All responses return HTTP 200 with a consistent envelope:
  • 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_used — credits consumed. Always 0 when no data is returned.
  • metadata.tokens_remaining — your remaining credit balance after this request.

​
When an endpoint is offline

A 500 with internal_error means the endpoint itself is temporarily unavailable:
Nothing about your request caused this — the API key, parameters, plan, and rate-limit headroom are all fine, and the same call will work again once the endpoint is back. The MoltSets team is alerted automatically, so there’s no need to report it. Resolution time varies, largely with when the outage starts: one that begins during office hours is picked up sooner than one overnight or over a weekend. Because of that, don’t build a fixed retry delay around it — treat it as a transient failure in your pipeline, not a bad record, and requeue the affected calls to retry later instead of looping on the endpoint. A later call succeeding is the signal that the endpoint is back.

​
Plans

Records are the data rows returned; requests are capped separately — see Rate Limits.
linkedin_to_personal_email and linkedin_to_best_personal_email are not available on every plan — access is set per account, not by price tier. Call get_account and read personal_email_available to know where yours stands.Calls from an account without access return 403 with:
Contact support@moltsets.com to request access.
Getting the $997/month plan for $497/month with the UGC Discount — How It Works.

​
Choosing a plan

The right plan depends on how fast you need results. Higher rate limits mean faster processing — the difference between waiting an hour and wrapping up in minutes.

​
More information

For more information on our plans, upgrading and downgrading processes, please refer to our support documentation at support.moltsets.com.

​
Available tools

* linkedin_to_personal_email and linkedin_to_best_personal_email are not available on every plan — access is set per account, not by price tier. Call get_account and read personal_email_available to know where yours stands. See Plans for the error they return. Without access, use linkedin_to_business_email instead.

​
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.