Influencers Club

Description for the public API of influencers.club

influencers.club API Documentation

How to Get Your API Key

Supported Platforms

1. Enrich Creator Profile

Enrich by email basic

Enrich by email advanced

Enrich by handle raw

Enrich by handle full

2. Creator Discovery API

Discovery API

Lookalikes with filters

Fetch Available Twitch Games

Fetch Available Languages

Fetch Available Locations for Platform

Fetch Available Youtube Topics

3. Get Post Data with Engagement Metrics

4. Check account credits and usage details

Pricing & Credit System

API Rate Limits

Error Handling

Iclub Public API

Production

Sandbox

<p class="slate-p " ><strong class="slate-bold">Welcome to the official Influencers Club API documentation.</strong>
 This API enables you to get detailed insights about a social media profile based on their email or username.</p><p class="slate-p " ></p><h3 class="slate-h3 " >Use Cases
</h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Enrich your CRM</strong> – Automatically append social media data to email signups. <em class="slate-italic">Use</em> <em class="slate-italic">Enrichment by Email endpoint.</em></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Find creator details</strong> – Get other social media profiles and email addresses for users signing up with only a username. <em class="slate-italic">Use Enrichment by Handle endpoint.</em></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Discover Creators</strong> – Allows you to get creator details, based on filters you&apos;ll apply. <em class="slate-italic">Use Disovery API.</em></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Get Post Data with Engagement Metrics</strong> - This endpoint allows you to retrieve detailed metrics for a specific social media post.</div></li></ul><p class="slate-p " >It works in two ways:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Database Enrichment</strong> – If we have the requested data, we return it instantly.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Real-Time Data</strong> – If we don’t have the data internally, we fetch it directly from the relevant platform in real-time.</div></li></ol><p class="slate-p " ></p><p class="slate-p " >For any API-related questions, <a href="https://influencers.club/schedule-meet/" target="_blank">contact us</a>.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><p class="slate-p " ></p></p>

Welcome to the official Influencers Club API documentation.


 This API enables you to get detailed insights about a social media profile based on their email or username.

<p class="slate-p " ><p class="slate-p " ><p class="slate-p " >To access the API, you must obtain an <strong class="slate-bold">API Key</strong>.</p></p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Register at <a href="https://dashboard.influencers.club/register" target="_blank">influencers.club Dashboard</a>.</div></li><li class="slate-li " ><div style="position:relative">After logging in, open the <a href="https://dashboard.influencers.club/api" target="_blank">API page</a>. </div></li><li class="slate-li " ><div style="position:relative">Your <strong class="slate-bold">API Key</strong> will be available there.
</div></li></ol><h3 class="slate-h3 " >Using the API Key</h3><p class="slate-p " >All requests require a <strong class="slate-bold">Bearer Token, should be in a format</strong>:</p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " >Authorization: Bearer YOUR_API_KEY</p></div></div></p>

<p class="slate-p " ></p><h3 class="slate-h3 " ><strong class="slate-bold">Available for the Enrichment API:</strong></h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Instagram</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">TikTok</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">YouTube</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">OnlyFans</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">X/Twitter</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Twitch</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Facebook</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Pinterest</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Discord</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Snapchat</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Reddit</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">LinkedIn</strong></div></li></ul><h3 class="slate-h3 " ><strong class="slate-bold">Available for the Discovery API:</strong></h3><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Instagram</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">TikTok</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">YouTube</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">OnlyFans</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">X/Twitter</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Twitch</strong></div></li></ul><p class="slate-p " ></p><p class="slate-p " ></p>

 allows you to filter creators based on the filters available on the dashboard, you can use the AI seach and lookalikes search to find profiles relevant to your targeting.

Below is the complete filters schema grouped by theme. Fields not applicable to the chosen platform are silently ignored.

Filter

Type

Notes

Social media

Platform

  Notes

Filters

<p class="slate-p " >This endpoint allows you to retrieve detailed metrics for a specific social media post. You need to specify the platform, the type of content, and provide the unique ID of the post you want to track. If a post has a large number of interactions, you can use the optional pagination token to fetch additional data in multiple requests.</p><p class="slate-p " >The response will include information about the users engaging with the post, including likes, comments, and shares. It also provides timestamps and links to the post, along with a pagination token when more data is available. This makes it easy to monitor post performance and track engagement over time.</p>

This endpoint allows you to retrieve detailed metrics for a specific social media post. You need to specify the platform, the type of content, and provide the unique ID of the post you want to track. If a post has a large number of interactions, you can use the optional pagination token to fetch additional data in multiple requests.

The response will include information about the users engaging with the post, including likes, comments, and shares. It also provides timestamps and links to the post, along with a pagination token when more data is available. This makes it easy to monitor post performance and track engagement over time.

platform

content_type

post_id

Token for fetching the next page of results. Leave empty on the first request; use the returned token in subsequent calls to load more comments.

pagination_token

Find your API key on the Profile Page after logging into your account on the dashboard.

Authorization

<p class="slate-p " >Use your API key to check your remaining credits and review your credit usage.</p>

Use your API key to check your remaining credits and review your credit usage.

<p class="slate-p " ></p><p class="slate-p " >The Enrichment API operates on a credit-based system. Each request consumes credits based on the data and features retrieved. Below is a detailed breakdown of the pricing structure:</p><p class="slate-p " ></p><h1 class="slate-h1 " >Enrichment API</h1><p class="slate-p " ></p><p class="slate-p " > </p><div class="published-table"><div class="table-container" style="padding-left: 0px;"><table class="slate-table" style="min-width:100%;"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:135px;">Endpoint</div><div style="width:237px;">Route</div><div style="width:124px;">Real-Time Scrape</div><div style="width:420px;">Details</div><div style="width:0px;">Credit Cost</div></div><colgroup ><col style="width:135px"><col style="width:237px"><col style="width:124px"><col style="width:420px"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " > Handle – Full    </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " > POST /v1/creators/enrich/handle/full  </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " > ✅                     </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Returns full information about the profile such as email, user info, post info, connected platforms, growth trends, posting frequency, stats.</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >1</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " > Handle – Raw     </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >POST /v1/creators/enrich/handle/raw   </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " > ✅                     </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Returns raw data including user info and post info</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.03</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " > Email – Regular  </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >POST /v1/creators/enrich/email</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " > ❌                     </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Returns only one social media, the one with the higher follower/subscriber count related to the creator.</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.1</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " > Email – Advanced </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >POST /v1/creators/enrich/email/advanced</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " > ❌                     </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Returns the all social medias for the creator with the full profile stats, follower growths, etc. </p><p class="slate-p " >And the option to exclude specific platform and to set min follower count.</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >2</p></td></div></tr></tbody></table></div></div><p class="slate-p " ></p><h1 class="slate-h1 " >Discovery API</h1><p class="slate-p " >The Discovery API operates on a credit-based system. Each request consumes credits, the number of creators you request (using the <code class="slate-code">limit</code> parameter) determines the total cost of a request:</p><div class="published-table"><div class="table-container" style="padding-left: 0px;"><table class="slate-table" style="min-width:100%;"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:270px;"> Requested Type </div><div style="width:269px;">Limit</div><div style="width:249px;">Cost per Creator</div><div style="width:0px;">    Total Cost per Request</div></div><colgroup ><col style="width:270px"><col style="width:269px"><col style="width:249px"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Request Creator</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >1 (min)</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.01</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.01</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Request Creator</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >50 (max)</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.01</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.5</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Find Similar Creators with Filters</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >1 (min)</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.01</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.01</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Find Similar Creators with Filters</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >50 (max)</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.01</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.5</p></td></div></tr></tbody></table></div></div><p class="slate-p " ></p><h1 class="slate-h1 " >Get Post Data with Engagement Metrics</h1><p class="slate-p " ></p><div class="published-table"><div class="table-container" style="padding-left: 0px;"><table class="slate-table" style="min-width:100%;"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:336px;">Request Type</div><div style="width:669px;">Cost per Request</div></div><colgroup ><col style="width:336px"><col style="width:669px"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Post Data with engagement metrics </p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0.03</p></td></div></tr></tbody></table></div></div><p class="slate-p " ></p>

The Enrichment API operates on a credit-based system. Each request consumes credits based on the data and features retrieved. Below is a detailed breakdown of the pricing structure:

Endpoint

Route

Real-Time Scrape

Details

Credit Cost

The Discovery API operates on a credit-based system. Each request consumes credits, the number of creators you request (using the 

 parameter) determines the total cost of a request:

 Requested Type 

Limit

Cost per Creator

    Total Cost per Request

Request Type

Cost per Request

<p class="slate-p " ></p><p class="slate-p " ></p><div class="published-table"><div class="table-container" style="padding-left: 0px;"><table class="slate-table" style="min-width:100%;"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:100px;">API Endpoint</div><div style="width:100px;">Limit</div><div style="width:100px;">Notes</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >All Endpoints</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >300 requests/minute</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Limit applies per account. Requests exceeding this limit will receive a <code class="slate-code">429 Too Many Requests</code> response.</p></td></div></tr></tbody></table></div></div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Reset Timing: The limit is measured per rolling minute.</div></li><li class="slate-li " ><div style="position:relative">Error Handling: When the limit is exceeded, the API responds with status code 429 and a message indicating the limit has been reached.</div></li><li class="slate-li " ><div style="position:relative">Best Practices:
- Batch requests where possible to optimize usage.
- Implement retry logic with exponential backoff when receiving a 429 response.
- Monitor your API usage regularly to avoid hitting the limit.</div></li></ul><p class="slate-p " ></p>

API Endpoint

<p class="slate-p " ><p class="slate-p " >(Pending developer confirmation.)</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">400 Bad Request</strong> – Invalid request parameters.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">401 Unauthorized</strong> – Invalid API key.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">403 Forbidden</strong> – Insufficient permissions.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">404 Not Found</strong> – No data found for given input.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">429 Too Many Requests</strong> – Rate limit exceeded.</div></li></ul></p><p class="slate-p " >📌 For any issues, reach out at <a href="https://influencers.club/schedule-meet/" target="_blank">Influencers Club API Support</a>.</p><p class="slate-p " ></p>

Sections