# API FAQ

This page answers common questions about API access, credits, pagination, enrichment, performance, and metric behavior.

### Who is the API for?

The API is designed for developers integrating programmatically, as well as operations and commercial teams running creator sourcing and enrichment workflows.

### Which plans include API access?

API access is available to **Pro** subscribers.

Trial accounts can test the API with **10 trial credits**.

### How do credits work?

Credits are deducted **only when a request successfully returns data**.
No credits are deducted when a request returns no results.

div
[Calculate Credits](/guides/usage-limits#credit-calculator)

### What are the rate limits?

The API is limited to **300 requests per minute per account**.

If you paginate large result sets, implement request throttling and backoff to stay within the limit.

### What is the maximum value for `limit`?

- Maximum `limit`: **50** results per page.


Each request returns one page only.

If you want 150 results with `limit=50`, you must make 3 requests:

- page 1
- page 2
- page 3


### How does pagination work?

Pagination is page-based:

- `page=1` returns the first page of results (up to `limit` results)
- `page=2` returns the second page of results (up to `limit` results), and so on


If you need results across multiple pages, you must request each page separately.

Example paging object:


```json
"paging": {
  "limit": 50,
  "page": 3
}
```

The example above returns **only page 3** (up to 50 results).

### Is there a maximum number of creators I can retrieve?

Up to **10,000** relevant results can be fetched by each query. Fetching data after the 10,000th result is not allowed.

### Are credits deducted for repeated requests with the same filters?

Yes. Every request that returns data deducts credits, regardless of whether the filters or parameters match a previous request. The API fetches **fresh, up-to-date data** on each call.

It is the client's responsibility to monitor request volume and credit usage. Use the [dashboard](https://dashboard.influencers.club/api) or `GET /public/v1/account/credits` to track remaining credits.

### What is the Discovery API Limit?

Each account gets a separate credit allowance specifically for using the Discovery API. This allowance is **10% of the total credits** included in the account's subscription plan.

For example, if a plan includes 10,000 credits, the Discovery API limit would be **1,000 credits**.

| Rule | Detail |
|  --- | --- |
| Credit source | 10% of the subscription's total credits, allocated as a separate Discovery API limit |
| Reset cycle | The limit resets automatically at the start of each billing cycle, along with the subscription renewal |
| Team-wide | The limit is shared across the entire team — it is not per user, but per account |


**Key takeaways:**

- Discovery API credits are separate from regular product credits — using the API does not eat into the main credit balance and vice versa.
- The limit applies to the whole team, so all team members draw from the same pool.
- The limit is based only on your subscription plan credits. Purchasing additional credits does not increase or reset the Discovery API limit.


### Does the Discovery API return emails?

No. Discovery returns creator profile data only.

To retrieve verified email addresses, use **Enrich by Handle – Full** after Discovery.

Typical workflow:

1. Discovery → collect handles
2. Enrich by Handle → retrieve detailed data (and email where available)


### How are emails validated?

**Enrich by Handle – Full** returns only **valid** email addresses when available.
Emails are validated via a third-party verification provider before inclusion.

### What is the difference between Enrich by Handle – Raw and Full?

#### Enrich by Handle – Raw

Returns unprocessed platform-specific data directly from the source, including basic profile information, post data, media counts, and platform-native metadata.

#### Enrich by Handle – Full

Returns complete profile data including cross-platform presence, engagement analytics, follower growth metrics, content performance data, monetization indicators, niche classification, hashtags, income estimates, and optional lookalike creator recommendations.

### Does the API return profile images?

Yes. Profile picture URLs are included in responses where available.

### Why are engagement metrics sometimes 0, null, or missing?

This most commonly happens when:

- the creator hides likes/views/comments
- the platform restricts metric visibility
- the metric is unavailable for the requested timeframe or content type


When a platform does not expose a metric, it cannot be reliably returned, and the value may appear as 0 or null.

### How does Batch Enrichment work?

Batch enrichment is designed for scale.

You can:

1. Upload a CSV (up to **10,000 contacts**)
2. Start the batch job
3. Download the enriched CSV output


Batch is recommended for large lists where you prefer asynchronous processing over making many individual requests.

### Recommended approach for large campaigns

For large sourcing workflows:

1. Use Discovery with clear sorting and paging.
2. Paginate programmatically until you reach your target volume.
3. Use Enrich by Handle – Full for the subset you need contact and analytics data.
4. Use Batch Enrichment for very large lists (up to 10,000 at a time).


### Support

For any issues or questions please contact **aleksandra@influencers.club**.