Skip to content
Similar Creators/
Similar Creators

Similar Creators

Request

Discover creators similar to a reference creator based on various similarity criteria.

What you get

  • Returns a paginated list of creator profiles that match the reference creator's characteristics, content style, audience, or other specified attributes.
  • Supports filtering by URL, username, or ID, and allows additional filters to refine similarity matching.
  • Useful for finding lookalike creators, competitors, or creators in the same niche.

Credits

  • 0.01 credits per creator returned. If no creators are returned, no credits are deducted.
  • Credits are consumed on every request that returns creators, even if the filters are identical to a previous request.
  • It is the client's responsibility to monitor request volume and credit usage.
  • Similar-creator results count against the same per-billing-period Discovery cap. See Usage & limits.
Security
Bearer
Body
required
platformstring
Value:"instagram"
Example:"instagram"
Discriminator
filter_keystringrequired
Enum:"url""username""id"
Example:"username"
filter_valuestringrequired

Email, platform url or profile handle

Example:"creator_handle"
pagingobject(PagingRequest)required
Example:
{
  "page": 0,
  "limit": 10
}
filtersobject(InstagramDiscoveryFilters)
POST
/public/v1/discovery/creators/similar/
curl -i -X POST \
  https://api-dashboard.influencers.club/public/v1/discovery/creators/similar/ \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "platform": "instagram",
    "filter_key": "url",
    "filter_value": "string",
    "paging": {
      "limit": 0,
      "page": 0
    },
    "filters": {
      "location": [
        "string"
      ],
      "type": "string",
      "gender": "string",
      "profile_language": [
        "string"
      ],
      "ai_search": "string",
      "keywords_in_bio": [
        "string"
      ],
      "exclude_keywords_in_bio": [
        "string"
      ],
      "hashtags": [
        "string"
      ],
      "not_hashtags": [
        "string"
      ],
      "keywords_in_captions": [
        "string"
      ],
      "keywords_not_in_captions": [
        "string"
      ],
      "link_in_bio": [
        "string"
      ],
      "not_link_in_bio": [
        "string"
      ],
      "number_of_followers": {
        "min": 0.1,
        "max": 0.1
      },
      "engagement_percent": {
        "min": 0.1,
        "max": 0.1
      },
      "average_likes": {
        "min": 0.1,
        "max": 0.1
      },
      "average_comments": {
        "min": 0.1,
        "max": 0.1
      },
      "number_of_posts": {
        "min": 0.1,
        "max": 0.1
      },
      "reels_percent": {
        "min": 0.1,
        "max": 0.1
      },
      "average_views_for_reels": {
        "min": 0.1,
        "max": 0.1
      },
      "posting_frequency": 0.1,
      "follower_growth": {
        "growth_percentage": 0.1,
        "time_range_months": 3
      },
      "income": {
        "min": 0.1,
        "max": 0.1
      },
      "last_post": "string",
      "has_videos": false,
      "exclude_private_profile": true,
      "is_verified": true,
      "brands": [
        "string"
      ],
      "audience": {
        "location": [
          {
            "name": "string",
            "type": "country",
            "min_pct": 0.1
          }
        ],
        "gender": {
          "type": "string",
          "min_pct": 0.1
        },
        "language": [
          {
            "language_abbr": "string",
            "min_pct": 0.1
          }
        ],
        "age": [
          {
            "range": "13-17",
            "min_pct": 0.1
          }
        ],
        "interests": [
          {
            "name": "string",
            "min_pct": 0.1
          }
        ],
        "brands": [
          "string"
        ],
        "brand_categories": [
          "string"
        ],
        "credibility": "bad"
      },
      "creator_has": {
        "has_amazonaffiliates": false,
        "has_applemusic": false,
        "has_bandcamp": false,
        "has_behance": false,
        "has_buymeacoffee": false,
        "has_cameo": false,
        "has_canva": false,
        "has_clubhouse": false,
        "has_discord": false,
        "has_dribbble": false,
        "has_etsy": false,
        "has_facebook": false,
        "has_fiverr": false,
        "has_github": false,
        "has_gofundme": false,
        "has_goodreads": false,
        "has_instagram": false,
        "has_kakao": false,
        "has_kickstarter": false,
        "has_kofi": false,
        "has_linkedin": false,
        "has_linktree": false,
        "has_medium": false,
        "has_onlyfans": false,
        "has_patreon": false,
        "has_personal_website": false,
        "has_phone": false,
        "has_pinterest": false,
        "has_podcast": false,
        "has_redbubble": false,
        "has_shopify": false,
        "has_shopltk": false,
        "has_snapchat": false,
        "has_spotify": false,
        "has_spring": false,
        "has_streamlabs": false,
        "has_substack": false,
        "has_telegram": false,
        "has_tiktok": false,
        "has_tumblr": false,
        "has_twitch": false,
        "has_twitter": false,
        "has_udemy": false,
        "has_viber": false,
        "has_vimeo": false,
        "has_vk": false,
        "has_weebly": false,
        "has_whatsApp": false,
        "has_youtube": false,
        "has_wix": false,
        "has_anchor": false,
        "has_soundcloud": false,
        "has_community": false
      },
      "promotes_affiliate_links": true,
      "has_done_brand_deals": true,
      "has_link_in_bio": true,
      "does_live_streaming": true,
      "has_merch": true,
      "exclude_role_based_emails": false,
      "exclude_handles": [
        "string"
      ],
      "exclude_list": [
        0
      ],
      "exclude_default_list": false,
      "exclude_all_lists": false
    }
  }'

Responses

Bodyapplication/json
totalintegerrequired
limitintegerrequired
credits_leftstring, (decimal)^-?\d{0,8}(?:\.\d{0,2})?$required
accountsArray of objects(AccountResponse)
Response
{
  "total": 0,
  "limit": 0,
  "credits_left": "string",
  "accounts": [
    { … }
  ]
}