Influencer API · Endpoint Endpoint reference

Influencer Enrich by handle (Profile) API

Enrich a creator handle with profile and contact data

Is there an API to get a creator’s contact and identity data from a handle?

Yes. The Influencers.club Profile enrichment endpoint returns the identity and contact layer — validated email, name, gender, location, cross-platform links, verification status, account type, follower and post counts, bio and niche — at 0.2 credits per successful request: the same validated email as Full, at a fifth of the price.

Verified against the live API in Endpoint reference →

What this endpoint returns

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

Measured
340M+
Searchable Influencer profiles
40+
Data points returned per creator
47
Platforms mapped in the social graph
6
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/profile/
Auth Authorization: Bearer <API_KEY> Content type application/json Rate 0.2 credits per successful request Full reference →
curl -X POST https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/profile/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"platform": "instagram", "handle": "mrbeast"}'
import requests

res = requests.post(
    "https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/profile/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "platform": "instagram",
        "handle": "mrbeast"
    }, ) print(res.json())
const res = await fetch("https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/profile/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "platform": "instagram",
    "handle": "mrbeast"
  }), }); const data = await res.json();
$ch = curl_init("https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/profile/");
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"}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
body := strings.NewReader(`{"platform": "instagram", "handle": "mrbeast"}`)
req, _ := http.NewRequest("POST", "https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/profile/", 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,
    "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",
    "twitter_link": "https://www.twitter.com/mrbeast",
    "links_in_bio": [
      "https://feastables.com/",
      "https://linktr.ee/beastgames"
    ],
    "instagram": {
      "username": "mrbeast",
      "userid": "2278169415",
      "full_name": "MrBeast",
      "follower_count": 89358505,
      "is_verified": true,
      "profile_picture": "https://pictures.influencersclub.workers.dev/img/…"
    }
  },
  "credits_cost": 0.2 }
Response fields JSON always returned · docs on request
FieldTypeMeaning
Envelope
result.emailstringVerified email for the creator (null if none found).
result.email_typestringbusiness · personal · role_based_email.
result.contact_phone_numberstringPhone number where available.
result.first_namestringFirst name.
result.locationstringCountry.
result.genderstringmale · female · null.
result.speaking_languagestringISO language code.
result.is_creator / is_businessbooleanAccount role flags.
result.creator_hasobjectPlatform → true for every connected account.
result.links_in_bio[]arrayLinks found in the bio.
result._linkstringURL of each connected account.
credits_costnumberCredits charged.
result.
username · userid · full_namestringIdentity on the platform.
follower_countintegerFollower count.
is_verifiedbooleanVerified badge.
profile_picturestringProfile picture URL.
Errors (400 / 403 / 429)
error_codestringMachine-readable slug, e.g. insufficient_credits. Always present on errors — branch on this, not on error.
errorstringHuman-readable description of what went wrong.
retry_afterintegerSeconds to wait before retrying a 429; mirrored in the Retry-After header.

Profile tier carries identity and contact fields; engagement, growth, income and audience come with the Analytics or Full tiers. Exact per-tier field list is in the endpoint reference.

Parameters

The spec

Parameter Type Accepted values Behaviour
POST /public/v1/creators/enrich/handle/profile/ endpoint platform, handle Returns the identity and contact layer only — who the creator is and how to reach them — without performance stats. Cheapest way to get a verified email for a handle.
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.
—
—

Billing. 0.2 credits 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/profile/ { "platform": "instagram", "handle": "<username from discovery>" }

Other creator data you can access

Influencer API endpoints

Platform coverage

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

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

FAQ

Frequently asked questions

What does this endpoint cost?+

0.2 credits 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 handle: profile and contact data using your API?+

Sign up for free and copy your API key from the dashboard. POST to /public/v1/creators/enrich/handle/profile/ with a platform and handle. You get back the creator’s verified email, phone, name, location, language and every connected account with follower counts — no performance stats. 0.2 credits 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.