# Usage, pricing, and limits

## Credits

The API is priced in credits.

- Credits are deducted only when a request returns data.
- Check your remaining balance with `GET /public/v1/accounts/credits/` or in the [Influencers Club dashboard](https://dashboard.influencers.club/api).


## Credit consumption

### Creators API (enrichment)

Credits are deducted per enriched record returned. Enrich creator content, creator posts, connected socials and audience overlap charge a flat amount per request instead.

| Endpoint | Mode | Credits |
|  --- | --- | --- |
| Enrich by handle | Raw | **0.03** |
| Enrich by handle | Profile | **0.2** |
| Enrich by handle | Analytics | **0.8** |
| Enrich by handle | Full | **1** |
| Enrich by email | — | **0.05** |
| Enrich creator content | per request | **0.03** |
| Creator posts | per request | **0.03** |
| Connected socials | per request | **0.5** |
| Audience overlap | per request | **1** |


### Discovery API

Credits are deducted per creator returned, not per request.

| Endpoint | Credits |
|  --- | --- |
| Discovery search | **0.01 per creator returned** |
| Similar creators | **0.01 per creator returned** |
| Discovery search with `return_filter_values=true` | **0.03 per creator returned** |


Adding `return_filter_values=true` moves a Discovery search from 0.01 to **0.03 credits per creator returned** — 0.03 in total, not 0.04. It does not change how the Discovery fair-use cap is counted.

Every request that returns creators consumes credits.

## Rate limits

The API is rate limited to **300 requests per minute**. Requests over the limit return `429`.

### Daily Discovery limit

Discovery also has a daily credit limit. Requests past it return `429` with `error_code` `daily_limit_exceeded` and a `retry_after` giving the seconds to wait. Your daily limit is shown in the [dashboard](https://dashboard.influencers.club/api).

### Trial plan

Trial accounts get **30 successful API requests**. Requests that return an error do not count.

## Discovery fair-use cap

Discovery has a fair-use cap on the number of unique creators returned, shared across your team.

### Your cap

Your cap increases at every renewal, and anything you did not use carries over. Canceling your subscription clears it. Your current figure is in the [dashboard](https://dashboard.influencers.club/api).

### How usage is counted

- A unique creator is one username on one platform — the same creator on two platforms counts as two.
- Within a billing period the same creator counts only once, however often you return them.


To have the cap raised, [book a call](https://influencers.club/schedule-meet/) and we'll review the use case with you.

### When the cap is reached

We email your account owner as you approach the cap and again when you reach it. Past the cap, Discovery pauses: `POST /public/v1/discovery/` and `POST /public/v1/discovery/creators/similar/` return HTTP 429 until your subscription renews.

This `429` is not the per-minute rate limit, the daily Discovery limit, or a batch limit — see [Error handling](/guides/error-handling) to tell them apart.

## Social listening (monitoring)

Two ways to use it:

- **Webhooks** — subscribe to a type of creator activity (new posts, bio or link-in-bio changes, follower milestones) and we push it to your app as it happens.
- **Campaigns** — group creators into a campaign and get the analytics layer on top: per-post metrics, engagement rate, estimated reach, and **Earned Media Value** (per post and campaign total), plus 7-day trends and an AI-written performance report. Export any of it to CSV.


### What it costs

**0.3 credits per creator, per day** — however you organize those creators into subscriptions or campaigns. Estimate a campaign as **creators × days × 0.3**:

| Campaign | Cost |
|  --- | --- |
| 25 creators · 7-day launch | **52.5 credits** |
| 50 creators · 30-day campaign | **450 credits** |


### How it's counted

- Billed per distinct creator, not per subscription or campaign. The same creator tracked in several places — or by several teammates — counts once.
- You pay for each day a creator is actually tracked. Removing a creator does not refund the day you remove them.
- Webhook deliveries, reports, and exports are all part of the per-creator price.


### Running out of credits

If your balance won't cover the day's charge, monitoring pauses. Top up and resume your subscriptions to continue.

### Limits

See the [dashboard](https://dashboard.influencers.club/api) for your current limits.

## Credit calculator

Estimate the cost of a call: pick an endpoint and the number of creators or records you expect back. It uses the rates listed under [Credit consumption](#credit-consumption).

Endpoint
Discovery search
Similar creators
Enrich by handle (Raw)
Enrich by handle (Full)
Enrich by handle (Profile)
Enrich by handle (Analytics)
Enrich by email
Enrich creator content
Creator Posts
Audience Overlap
Connected Socials
Discovery search
Quantity
Number of creators/records returned
Calculate
Reset
—
Choose an endpoint and enter a quantity.
**Quick reference** — multiply quantity by credit rate:

| Endpoint | Credits |
|  --- | --- |
| Discovery search | 0.01 per creator returned |
| Discovery search with `return_filter_values=true` | 0.03 per creator returned |
| Similar creators | 0.01 per creator returned |
| Enrich by handle (Raw) | 0.03 |
| Enrich by handle (Full) | 1 |
| Enrich by handle (Profile) | 0.2 |
| Enrich by handle (Analytics) | 0.8 |
| Enrich by email | 0.05 |
| Enrich creator content | 0.03 per request |
| Creator posts | 0.03 per request |
| Audience overlap | 1 per request |
| Connected socials | 0.5 per request |