Influencer API · Endpoint Endpoint reference

Influencer Similar Creators API

Find similar creators with the lookalikes API

Is there an API to find creators similar to one you already know?

Yes. The Influencers.club Similar Creators endpoint takes a reference creator — by URL, username or ID — and returns ranked lookalikes with a similarity score, on Instagram, YouTube, TikTok, Twitch, Twitter and OnlyFans. Stack any discovery filter on top to keep the lookalikes inside your size band, market or niche, and get back full profiles with follower counts, engagement rates and verified contact data.

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/discovery/creators/similar/
Auth Authorization: Bearer <API_KEY> Content type application/json Rate 0.01 credits per creator returned Full reference →
curl -X POST https://api-dashboard.influencers.club/public/v1/discovery/creators/similar/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"platform": "instagram", "filter_key": "username", "filter_value": "mrbeast", "paging": {"limit": 20, "page": 0}}'
import requests

res = requests.post(
    "https://api-dashboard.influencers.club/public/v1/discovery/creators/similar/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "platform": "instagram",
        "filter_key": "username",
        "filter_value": "mrbeast",
        "paging": {
            "limit": 20,
            "page": 0
        }
    }, ) print(res.json())
const res = await fetch("https://api-dashboard.influencers.club/public/v1/discovery/creators/similar/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "platform": "instagram",
    "filter_key": "username",
    "filter_value": "mrbeast",
    "paging": {
      "limit": 20,
      "page": 0
    }
  }), }); const data = await res.json();
$ch = curl_init("https://api-dashboard.influencers.club/public/v1/discovery/creators/similar/");
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", "filter_key": "username", "filter_value": "mrbeast", "paging": {"limit": 20, "page": 0}}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
body := strings.NewReader(`{"platform": "instagram", "filter_key": "username", "filter_value": "mrbeast", "paging": {"limit": 20, "page": 0}}`)
req, _ := http.NewRequest("POST", "https://api-dashboard.influencers.club/public/v1/discovery/creators/similar/", 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
{
  "total": 10388,
  "limit": 2,
  "accounts": [
    {
      "user_id": "uc_9647719",
      "profile": {
        "full_name": "Jacob Correia | Weight loss coach",
        "username": "iampeachfit",
        "picture": "https://pictures.influencersclub.workers.dev/img/…",
        "followers": 1062751,
        "engagement_percent": 0.14
      },
      "similarity_score": 0.7219
    },
    {
      "user_id": "uc_1520986",
      "profile": {
        "full_name": "Niko Valdes",
        "username": "nikovaldes",
        "picture": "https://pictures.influencersclub.workers.dev/img/…",
        "followers": 1052773,
        "engagement_percent": 1.18
      },
      "similarity_score": 0.7186
    }
  ],
  "credits_left": 357.68,
  "credits_cost": 0.02 }
Response fields JSON always returned · docs on request
FieldTypeMeaning
Envelope
totalintegerNumber of similar creators available for this reference creator.
limitintegerPage size you requested.
accounts[]arraySimilar creators on this page, ranked by similarity.
credits_leftnumberRemaining credit balance after this request.
credits_costnumberCredits charged — 0.01 × creators returned.
Each account
user_idstringInfluencers.club creator ID (uc_…). Pass it to enrichment.
profile.full_namestringDisplay name.
profile.usernamestringHandle on the platform.
profile.picturestringProfile picture URL.
profile.followersintegerFollower count.
profile.engagement_percentnumberEngagement rate.
similarity_scorenumber0–1 similarity to the reference creator.
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.

Results are always sorted by relevance; there is no custom sort or CSV export. Pass the reference creator as username, url or id via filter_key.

Parameters

The spec

Parameter Type Accepted values Behaviour
POST /public/v1/discovery/creators/similar/ endpoint platform, filter_key, filter_value, filters, paging Returns creators ranked by similarity score, highest first. Optional filters use the same schema as Discovery; exclude_list / exclude_default_list apply your exclusion lists. Counts toward the Discovery fair-use cap.
platform string, required instagram · youtube · tiktok · twitch · onlyfans Platform of the reference creator.
filter_key string username · url · id How you identify the reference creator. Defaults to username.
filter_value string, required A handle, profile URL or platform ID The reference creator.
paging object { "limit": 1–50, "page": 0-based } Page size and page number.

Billing. 0.01 credits per creator returned, not per request. Counts toward the Discovery fair-use cap. If no creators are returned, no credits are deducted.

Recipes

How teams use this endpoint

Three ways this fits a creator-data workflow.

One call to try it

20 lookalikes for one handle, ranked by similarity.

platform: "instagram", "filter_key": "username", "filter_value": "mrbeast"

Narrow with Discovery filters

Same filter schema as Discovery — keep lookalikes in a follower band or a country.

POST /public/v1/discovery/creators/similar/ {
  "platform": "instagram",
  "filter_value": "mrbeast",
  "filters": {
    "number_of_followers": { "min": 50000, "max": 500000 },
    "location": ["United States"]
  } }

Skip creators you already know

Apply your exclusion lists so past partners never come back.

POST /public/v1/discovery/creators/similar/ {
  "platform": "instagram",
  "filter_value": "mrbeast",
  "filters": { "exclude_default_list": true } }

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.01 credits per creator returned, not per request. If no creators are 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 find similar creators via lookalikes using your API?+

Sign up for free and copy your API key from the dashboard. POST to /public/v1/discovery/creators/similar/ with the platform and the reference creator (filter_key username, url or id plus filter_value). You get back a ranked page of lookalike profiles with followers, engagement and a similarity_score; add filters or paging as you would on Discovery. 0.01 credits per creator returned.

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.