Influencer API · Endpoint Endpoint reference

Influencer Enrich by email API

Turn an email into a full social profile

Is there an API to find someone’s social profiles from their email?

Yes. The Influencers.club Email enrichment endpoint takes an email address and returns the creator profiles connected to it across platforms — reverse lookup from inbox to influence.

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/email/
Auth Authorization: Bearer <API_KEY> Content type application/json Rate 0.05 credits per successfully enriched email Full reference →
curl -X POST https://api-dashboard.influencers.club/public/v1/creators/enrich/email/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"email": "contact@mrbeastbusiness.com"}'
import requests

res = requests.post(
    "https://api-dashboard.influencers.club/public/v1/creators/enrich/email/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "email": "contact@mrbeastbusiness.com"
    }, ) print(res.json())
const res = await fetch("https://api-dashboard.influencers.club/public/v1/creators/enrich/email/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "email": "contact@mrbeastbusiness.com"
  }), }); const data = await res.json();
$ch = curl_init("https://api-dashboard.influencers.club/public/v1/creators/enrich/email/");
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, '{"email": "contact@mrbeastbusiness.com"}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
body := strings.NewReader(`{"email": "contact@mrbeastbusiness.com"}`)
req, _ := http.NewRequest("POST", "https://api-dashboard.influencers.club/public/v1/creators/enrich/email/", 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": {
    "platform": "youtube",
    "userId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "url": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
    "username": "@mrbeast",
    "fullname": "Chucky",
    "picture": "https://pictures.influencersclub.workers.dev/img/…",
    "followers": 512000000
  },
  "credits_cost": 0.05 }
Response fields JSON always returned · docs on request
FieldTypeMeaning
result
platformstringPlatform of the matched profile.
userIdstringPlatform user / channel ID.
urlstringProfile URL.
usernamestringHandle.
fullnamestringDisplay name.
picturestringProfile picture URL.
followersintegerFollower or subscriber count.
Envelope
credits_costnumberCredits charged (0.05).
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.

If no creator is linked to the email, the request returns no result and nothing is charged.

Parameters

The spec

Parameter Type Accepted values Behaviour
POST /public/v1/creators/enrich/email/ endpoint email Reverse lookup: one email in, the creator profile it belongs to out. Returns the primary matched account with platform, ID, handle and followers; chain into Connected Socials or Full enrichment for the rest.
email string, required A valid email address The email to look up.

Billing. 0.05 credits per successfully enriched email. If no profile is found for the email, no credits are deducted.

Recipes

How teams use this endpoint

Three ways this fits a creator-data workflow.

One email in

The cheapest way to find out whether a lead is a creator.

email: "contact@mrbeastbusiness.com"

Then get every platform

Pass the returned handle to Connected Socials.

POST /public/v1/creators/socials/ { "platform": "youtube", "handle": "UCX6OQ3DkcsbYNE6H8uQQuVA" }

Enrich a whole email list

Batch enrichment accepts a CSV with an email column.

POST /public/v1/enrichment/batch/ multipart/form-data: file=emails.csv, enrichment_mode=basic

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.05 credits per successfully enriched email. If no profile is found, 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 turn an email into a full social profile using your API?+

Sign up for free and copy your API key from the dashboard. POST to /public/v1/creators/enrich/email/ with an email. You get back the creator profile connected to it — platform, ID, handle, name and followers — for 0.05 credits. Pass that handle to Connected Socials or Full enrichment for the complete picture.

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.