Influencer API · Endpoint Endpoint reference

Influencer Enrich by handle (Full) API

Enrich a creator handle into a full profile

Is there an API to turn a handle into a full creator profile?

Yes. The Influencers.club Full enrichment endpoint takes any social handle and returns the complete profile: verified email, cross-platform presence, engagement and growth analytics, income estimates, audience demographics, and brand-deal history. One call, 1 credit, only charged on success.

Verified against the live API in August 2026 Endpoint reference →

What this endpoint returns

Counted on the live search index, not modelled or rounded.

Measured August 2026

340M+

Searchable Influencer profiles

40+

Data points returned per creator

Platforms mapped in the social graph

Platforms with full discovery support

Request

Make the call

Both samples below are complete. Paste one in, swap the key, get a 200.

POST https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/full/

Auth Authorization: Bearer <API_KEY> Content type application/json Rate 1 credit per successful request Full reference →

curl -X POST https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/full/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"platform": "instagram", "handle": "mrbeast", "include_audience_data": true}'

import requests

res = requests.post(
    "https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/full/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "platform": "instagram",
        "handle": "mrbeast",
        "include_audience_data": true
    }, ) print(res.json())

const res = await fetch("https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/full/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "platform": "instagram",
    "handle": "mrbeast",
    "include_audience_data": true
  }), }); const data = await res.json();

$ch = curl_init("https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/full/");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer YOUR_API_KEY",
  "Content-Type: application/json", ]);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"platform": "instagram", "handle": "mrbeast", "include_audience_data": true}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

body := strings.NewReader(`{"platform": "instagram", "handle": "mrbeast", "include_audience_data": true}`)
req, _ := http.NewRequest("POST", "https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/full/", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Response

What comes back

A 200 with the page of creators and your remaining credit balance. Creator values below are elided — field names and types are exactly as published in the API schema.

200 OKJSON

{
  "result": {
    "email": "contact@mrbeastbusiness.com",
    "email_type": "role_based_email",
    "contact_phone_number": "+19172596364",
    "first_name": "Chucky",
    "location": "United States",
    "gender": "male",
    "speaking_language": "en",
    "is_creator": true,
    "is_business": false,
    "has_brand_deals": true,
    "creator_has": {
      "instagram": true,
      "tiktok": true,
      "twitch": true,
      "twitter": true,
      "youtube": true
    },
    "instagram_link": "https://www.instagram.com/mrbeast",
    "youtube_link": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
    "tiktok_link": "https://www.tiktok.com/@6614519312189947909",
    "instagram": {
      "username": "mrbeast",
      "userid": "2278169415",
      "full_name": "MrBeast",
      "follower_count": 89358505,
      "engagement_percent": 1.32,
      "avg_likes": 3648544.83,
      "avg_comments": 67474.92,
      "posting_frequency_recent_months": 5.0,
      "most_recent_post_date": "2026-09-09",
      "reels": {
        "avg_view_count": 17430201.5,
        "median_view_count": 14571607.0
      },
      "creator_follower_growth": {
        "3_months_ago": 2.66,
        "12_months_ago": 28.48
      },
      "income": {
        "min": 1797900,
        "max": 2337400,
        "currency": "USD"
      },
      "niche_class": [
        "Arts & Entertainment",
        "Lifestyle"
      ],
      "post_data": [
        "…"
      ],
      "audience": {
        "…": "…"
      }
    },
    "youtube": {
      "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
      "custom_url": "@mrbeast",
      "subscriber_count": 512000000,
      "engagement_percent": 2.52
    },
    "tiktok": {
      "username": "mrbeast",
      "follower_count": 138071183,
      "engagement_percent": 8.39
    },
    "twitter": {
      "username": "mrbeast",
      "follower_count": 34979265
    },
    "twitch": {
      "username": "mrbeast6000",
      "total_followers": 637817
    }
  },
  "credits_cost": 1.0 }

Response fields JSON always returned · docs on request

Field	Type	Meaning
Envelope
result.email	string	Verified email for the creator (null if none found).
result.email_type	string	business · personal · role_based_email.
result.contact_phone_number	string	Phone number where available.
result.first_name	string	First name.
result.location	string	Country.
result.gender	string	male · female · null.
result.speaking_language	string	ISO language code.
result.is_creator / is_business	boolean	Account role flags.
result.has_brand_deals	boolean	Whether sponsored content was detected.
result.creator_has	object	Platform → true for every connected account.
result.links_in_bio[]	array	Links found in the bio.
result._link	string	URL of each connected account.
credits_cost	number	Credits charged.
result.instagram (per-platform block)
username · userid · full_name	string	Identity on the platform.
follower_count · following_count · media_count	integer	Profile counts.
engagement_percent	number	Engagement rate.
avg_likes · avg_comments · likes_median · comments_median	number	Engagement stats over recent posts.
reels	object	avg / median likes and views for Reels.
posting_frequency_recent_months	number	Posts per month.
most_recent_post_date	string	Date of the last post.
creator_follower_growth	object	% growth 3 / 6 / 9 / 12 months ago.
income	object	Estimated earnings range with currency.
niche_class[]	array	Niche categories.
hashtags[] · tagged[] · post_data[]	array	Recent hashtags, tagged accounts and posts with engagement.
audience	object	Demographics, credibility, interests and brand affinities (include_audience_data=true, 10k+ followers).
Other connected platforms
result.youtube · tiktok · twitter · twitch · onlyfans	object	Same identity and stats block for every connected account.
Errors (400 / 403 / 429)
error_code	string	Machine-readable slug, e.g. insufficient_credits. Always present on errors — branch on this, not on error.
error	string	Human-readable description of what went wrong.
retry_after	integer	Seconds to wait before retrying a 429; mirrored in the Retry-After header.

Audience data needs include_audience_data=true and 10k+ followers on Instagram, TikTok or YouTube. Set email_required to must_have to return only creators with a verified email. post_data and audience are truncated above.

Parameters

The spec

Parameter	Type	Accepted values	Behaviour
POST /public/v1/creators/enrich/handle/full/	endpoint	platform, handle, include_audience_data, include_lookalikes, email_required	Returns everything Influencers.club knows about the creator: verified contact, the full cross-platform graph, per-platform performance stats, growth, income estimate, recent posts and — with include_audience_data — audience demographics.
platform	string, required	instagram · youtube · tiktok · twitch · twitter · onlyfans	Platform the handle belongs to.
handle	string, required	username, profile URL or YouTube channel ID	Normalised automatically — @ stripped, URLs parsed.
include_audience_data	boolean	true · false	Adds audience demographics for IG / TikTok / YouTube creators with 10k+ followers.
include_lookalikes	boolean	true · false	Adds ranked lookalike creators.

Billing. 1 credit per successful request. If the handle can’t be resolved, no credits are deducted.

Recipes

How teams use this endpoint

Three ways this fits a creator-data workflow.

One creator, one call

Look up a single handle before the outreach.

platform: "instagram", "handle": "mrbeast"

Enrich a whole CSV

Batch enrichment runs the same lookup on up to 10,000 handles.

POST /public/v1/enrichment/batch/ multipart/form-data: file=handles.csv, platform=instagram, enrichment_mode=full

Discover, then enrich the winners

Filter with Discovery, pull full data only for creators that pass.

POST /public/v1/discovery/ { "platform": "instagram", "filters": { "number_of_followers": { "min": 10000, "max": 100000 }, "engagement_percent": { "min": 2 } } }

POST /public/v1/creators/enrich/handle/full/ { "platform": "instagram", "handle": "<username from discovery>" }

Other creator data you can access

Influencer API endpoints

Tracking and Posts · 7

Campaigns Creator Posts Events Post Comments Post Details Post Transcripts Subscriptions

Platform coverage

Six platforms with full data, 40+ more in the social graph

Instagramdiscovery · full data

TikTokdiscovery · full data

YouTubediscovery · full data

X / Twitterdiscovery · full data

Twitchdiscovery · full data

OnlyFansdiscovery · full data

Plus Facebook, Pinterest, Reddit, LinkedIn, Discord, Snapchat,
Linktree and 40+ more via connected socials.

FAQ

Frequently asked questions

What does this endpoint cost?+

1 credit per successful request. If the handle can’t be resolved, no credits are deducted.

Where can I find my API key?+

Create a free account. You will find your API key through the API side menu.

How do I enrich a creator handle into a full profile using your API?+

Sign up for free and copy your API key from the dashboard. POST to /public/v1/creators/enrich/handle/full/ with a platform and the creator’s handle, profile URL or YouTube channel ID. You get back one object with verified email and phone, every connected platform with followers and engagement, growth, income estimate, recent posts and (with include_audience_data) audience demographics. 1 credit per successful request.

What are your pricing plans and what do they include?+

Paid plans start at $249/month and use a flexible credit-based model.

Each API call consumes a specific number of credits depending on the endpoint and data depth. You can compare all tiers, credit amounts, and per-endpoint costs in the Pricing section of our API docs.

How can I get in touch with your team?+

Book a time on our calendar to talk to someone from our team and learn about the full capabilities of our API.