Influencer API · Endpoint Endpoint reference

Influencer Enrich by handle (Raw) API

Get raw user and post metadata for a handle

Is there an API to get raw profile and post metadata for a handle?

Yes. The Influencers.club Raw enrichment endpoint returns unprocessed user and post metadata for a specific handle at 0.03 credits per request — the cheapest way to check a profile programmatically, and the only enrichment tier that also supports LinkedIn.

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/raw/

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

curl -X POST https://api-dashboard.influencers.club/public/v1/creators/enrich/handle/raw/ \
  -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/raw/",
    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/raw/", {
  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/raw/");
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/raw/", 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": {
    "instagram": {
      "userid": "2278169415",
      "exists": true,
      "username": "mrbeast",
      "full_name": "MrBeast",
      "biography": "Watch my latest video!! 👇",
      "profile_picture": "https://pictures.influencersclub.workers.dev/img/…",
      "follower_count": 89358505,
      "following_count": 1003,
      "media_count": 508,
      "is_private": false,
      "is_verified": true,
      "is_business_account": false,
      "video_content_creator": true,
      "links_in_bio": [
        "https://www.youtu.be/gTKS8SAwUzE"
      ],
      "post_data": [
        {
          "post_id": "3982048237845084039",
          "created_at": "2026-09-09T16:02:00",
          "caption": "There’s never been a class that’s more excited about reading than this one",
          "post_url": "https://instagram.com/p/DdDE8ZHOfeH",
          "media": [
            {
              "type": "video",
              "url": "https://…mp4"
            }
          ],
          "engagement": {
            "likes": 193822,
            "comments": 30230,
            "view_count": 10580900
          },
          "media_type": 2,
          "product_type": "clips",
          "tagged_users": [],
          "hashtags": []
        }
      ]
    }
  },
  "credits_cost": 0.03 }

Response fields JSON always returned · docs on request

Field	Type	Meaning
result.
userid · username · full_name	string	Identity on the platform.
exists	boolean	Whether the profile was found.
biography	string	Bio text.
follower_count · following_count · media_count	integer	Profile counts.
is_private · is_verified · is_business_account	boolean	Account flags.
links_in_bio[]	array	Links in the bio.
post_data[]	array	Recent posts — post_id, caption, post_url, media[], engagement, media_type, hashtags, tagged_users.
Envelope
credits_cost	number	Credits charged (0.03).
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.

Raw returns a single platform block keyed by the platform you passed; nothing is resolved across platforms. post_data is truncated to one post above.

Parameters

The spec

Parameter	Type	Accepted values	Behaviour
POST /public/v1/creators/enrich/handle/raw/	endpoint	platform, handle	Returns the unprocessed profile and recent posts straight from the platform — counts, bio, links and post metadata — with no cross-platform resolution, contact data or audience. Supports LinkedIn.
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.03 credits per successful request. If no data is returned, 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=raw

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/raw/ { "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?+

0.03 credits per successful request. If no data is returned, 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 get raw user and post metadata for a handle using your API?+

Sign up for free and copy your API key from the dashboard. POST to /public/v1/creators/enrich/handle/raw/ with a platform and handle. You get back the unprocessed profile — bio, counts, flags, links in bio — and recent posts with engagement, for 0.03 credits. Use Profile, Analytics or Full when you need contact data, cross-platform links or audience.

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.