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

# Overview

> What MoltSets is, how it works, and where to start.

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/linkedin_to_best_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:

```bash theme={null}
curl -X POST https://api.moltsets.com/api/v1/tools/linkedin_to_best_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:

```json theme={null}
{
  "results": { ... },
  "status": "ok",
  "metadata": {
    "tokens_used": 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_used`** — credits consumed. Always `0` when no data is returned.
* **`metadata.tokens_remaining`** — your remaining credit balance after this request.

## Plans

| **Plan**     | **Lifetime Tokens** | **Rate Limit**                               | **External Tokens** |
| :----------- | :------------------ | :------------------------------------------- | :------------------ |
| \$0          | 1000                | 1k enrichment records lifetime               | 100                 |
| \$27 / month | Unlimited           | 5k enrichment & 2.5k search records / week   | 100 / month         |
| \$97 / month | Unlimited           | 75k enrichment & 37.5k search records / week | 500 / month         |
| \$997        | Unlimited           | 900k enrichment & 450k search records / week | 2500 / month        |

> [Getting the \$997/month plan for \$497/month with the UGC Discount — How It Works](https://support.moltsets.com/en/articles/15207288).

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

| **Plan**     | **Ideal for**                                                    |
| :----------- | :--------------------------------------------------------------- |
| \$0          | Exploring the API and testing integrations                       |
| \$27 / month | Low-volume agents or early production use                        |
| \$97 / month | Teams running identity resolution at scale                       |
| \$997        | High-throughput pipelines with sustained or unpredictable volume |

## More information

For more information on our plans, upgrading and downgrading processes, please refer to our support documentation at [support.moltsets.com](http://support.moltsets.com).

## Available tools

| Category           | Tools                                                                                                                            |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| **Account**        | `get_account`, `get_billing`, `get_usage`                                                                                        |
| **Email**          | `linkedin_to_best_email`, `linkedin_to_business_email`, `linkedin_to_personal_email`, `hem_to_email`, `business_email_to_sha256` |
| **LinkedIn**       | `search_linkedin_profile`, `linkedin_to_sha256`, `linkedin_to_business_profile`                                                  |
| **Phone**          | `linkedin_to_mobile_phone`                                                                                                       |
| **HEM Resolution** | `hem_to_linkedin`, `hem_to_best_linkedin`, `hem_to_business_profile`, `email_to_maid`                                            |
| **IP Resolution**  | `ip_to_hem`, `ip_to_maid`, `ip_to_company`                                                                                       |

## What to do next

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/getting-started/authentication">
    Get your API key and learn how to authenticate requests.
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/getting-started/rate-limits">
    Understand the limits that apply to all plans.
  </Card>
</CardGroup>