Skip to content

Core API Concepts (1.0.0)

Discovery

Identify and evaluate creators using structured, platform-specific search criteria. Responses are intentionally constrained to support ranking, filtering, and selection at scale rather than full profile hydration.

Enrichment

Retrieve complete creator-level data once a candidate has been identified. Enrichment responses provide the depth required for analysis, activation, and downstream data workflows.

Execution modes

Enrichment is available in both synchronous and asynchronous forms. Single enrichment supports real-time use cases, while batch enrichment is optimized for high-throughput, non-interactive processing.

Typical usage

Discovery and enrichment are designed as complementary stages. Discovery narrows the candidate set; enrichment supplies detailed data for creators that have already been qualified.

Languages
Servers
Production
https://api-dashboard.influencers.club

Discovery API

Operations

Similar Creators

Operations

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.
Security
Bearer
Headers
Authorizationstringrequired

Bearer << Client JWT Token >>

Body
required
platformstring
filter_keystringrequired
Enum"url""username""id"
filter_valuestringnon-emptyrequired

Email, platform url or profile handle

filtersobject or null

Discovery filters are platform-dependent.

The API accepts a superset of all filters across platforms, but only a subset is applied depending on the selected platform in the request.

We annotate fields with "Supported platforms" in the OpenAPI schema so users can understand what applies where (Redocly cannot dynamically change the form based on the selected platform).

pagingobject(PagingRequest)required
paging.​limitintegerrequired
paging.​pageintegerrequired
curl -i -X POST \
  https://api-dashboard.influencers.club/public/v1/discovery/creators/similar/ \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "platform": "string",
    "filter_key": "url",
    "filter_value": "string",
    "filters": {
      "location": [
        "string"
      ],
      "type": "string",
      "gender": "string",
      "profile_language": [
        "string"
      ],
      "ai_search": "string",
      "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_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
      },
      "exclude_role_based_emails": false,
      "exclude_previous": false,
      "number_of_followers": {
        "min": 0.1,
        "max": 0.1
      },
      "posting_frequency": 0.1,
      "follower_growth": {
        "growth_percentage": 0.1,
        "time_range_months": 3
      },
      "average_likes": {
        "min": 0.1,
        "max": 0.1
      },
      "average_comments": {
        "min": 0.1,
        "max": 0.1
      },
      "average_views": {
        "min": 0.1,
        "max": 0.1
      },
      "average_video_downloads": {
        "min": 0.1,
        "max": 0.1
      },
      "has_tik_tok_shop": true,
      "exclude_private_profile": true,
      "is_verified": true,
      "has_link_in_bio": true,
      "has_done_brand_deals": true,
      "promotes_affiliate_links": true,
      "does_live_streaming": true,
      "keywords_in_bio": [
        "string"
      ],
      "keywords_in_tweets": [
        "string"
      ],
      "number_of_tweets": {
        "min": 0.1,
        "max": 0.1
      },
      "last_post": "string",
      "last_upload_long_video": "string",
      "last_upload_short_video": "string",
      "most_recent_stream_date": "string",
      "last_active": "string",
      "income": {
        "min": 0.1,
        "max": 0.1
      },
      "number_of_subscribers": {
        "min": 0.1,
        "max": 0.1
      },
      "topics": [
        "string"
      ],
      "keywords_in_video_titles": [
        "string"
      ],
      "keywords_in_description": [
        "string"
      ],
      "keywords_not_in_description": [
        "string"
      ],
      "keywords_in_video_description": [
        "string"
      ],
      "keywords_not_in_video_description": [
        "string"
      ],
      "exclude_keywords_in_bio": [
        "string"
      ],
      "keywords_in_captions": [
        "string"
      ],
      "link_in_bio": [
        "string"
      ],
      "links_from_description": [
        "string"
      ],
      "links_from_video_description": [
        "string"
      ],
      "hashtags": [
        "string"
      ],
      "not_hashtags": [
        "string"
      ],
      "not_video_description": [
        "string"
      ],
      "video_description": [
        "string"
      ],
      "tweets": [
        "string"
      ],
      "brands": [
        "string"
      ],
      "subscriber_growth": {
        "growth_percentage": null,
        "time_range_months": 3
      },
      "has_shorts": true,
      "has_podcast": false,
      "has_videos": false,
      "has_free_account": false,
      "has_live_streams": false,
      "has_courses": false,
      "has_membership": false,
      "has_live_videos": false,
      "shorts_percentage": {
        "min": 0.1,
        "max": 0.1
      },
      "has_community_posts": false,
      "streams_live": false,
      "has_merch": false,
      "average_views_on_long_videos": {
        "min": 0.1,
        "max": 0.1
      },
      "median_views_long": {
        "min": 0.1,
        "max": 0.1
      },
      "average_views_on_shorts": {
        "min": 0.1,
        "max": 0.1
      },
      "number_of_videos": {
        "min": 0.1,
        "max": 0.1
      },
      "video_count": {
        "min": 0.1,
        "max": 0.1
      },
      "tweets_count": {
        "min": 0.1,
        "max": 0.1
      },
      "is_monetizing": false,
      "long_video_duration": {
        "min": 0.1,
        "max": 0.1
      },
      "average_stream_views": {
        "min": 0.1,
        "max": 0.1
      },
      "average_stream_duration": {
        "min": 0.1,
        "max": 0.1
      },
      "last_stream_upload": "string",
      "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
      },
      "subscription_price": {
        "min": 0.1,
        "max": 0.1
      },
      "number_of_photos": {
        "min": 0.1,
        "max": 0.1
      },
      "number_of_likes": {
        "min": 0.1,
        "max": 0.1
      },
      "followers": {
        "min": 0.1,
        "max": 0.1
      },
      "active_subscribers": {
        "min": 0.1,
        "max": 0.1
      },
      "streamed_hours_last_30_days": {
        "min": 0.1,
        "max": 0.1
      },
      "total_hours_streamed": {
        "min": 0.1,
        "max": 0.1
      },
      "maximum_views_count": {
        "min": 0.1,
        "max": 0.1
      },
      "avg_views_last_30_days": {
        "min": 0.1,
        "max": 0.1
      },
      "streams_count_last_30_days": {
        "min": 0.1,
        "max": 0.1
      },
      "games_played": [
        "string"
      ],
      "is_twitch_partner": false,
      "engagement_percent": {
        "min": 0.1,
        "max": 0.1
      }
    },
    "paging": {
      "limit": 0,
      "page": 0
    }
  }'

Responses

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

Dictionary

Provides the complete set of supported filter values used by the Discovery and Similar Creators endpoints.

These endpoints return all valid, platform-specific values (such as languages, locations, brands, YouTube topics, and Twitch games) that can be used when constructing discovery queries.

Clients should retrieve dictionary values programmatically to ensure only supported values are sent in requests. Available values may vary by platform and can evolve over time.

Operations

Enrich by handle full

Operations

Enrich by handle raw

Operations

Enrich by email advanced

Operations

Enrich by email basic

Operations

Batch enrichment

Bulk enrichment jobs: create, check status, resume, and download results.

Operations

Post Details

Operations

Account credits & usage

Account-level endpoints (credits, usage).

Operations