Skip to content
Discovery API/
Discovery API

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

Discovery API

Request

Search and discover creators across multiple platforms using advanced filtering and search.

Platform-specific filters

  • The available filters depend on the platform you choose.
  • When you switch platform, you’ll see different filter fields available in the request body for that platform.
  • If a request returns 0 creators, 0 credits are deducted.

Credits

  • 0.01 credits per creator returned

What you get

  • Returns a paginated list of creator profiles matching your criteria, including profile information, follower counts, engagement rates, and basic analytics.
  • Supports filtering by location, language, follower ranges, engagement metrics, content type, monetization status, brand partnerships, keywords, hashtags, posting frequency, and many other criteria.
  • Supports Instagram, YouTube, TikTok, Twitch, Twitter, and OnlyFans platforms.

Platform-specific filters

  • Filters depend on the platform you select.
  • In the request body schema below, switch platform to see which filter fields are available for that platform.
Security
Bearer
Body
platformstringrequired
Value"instagram"
Discriminator
pagingobject(PagingRequest)required
paging.​limitintegerrequired
paging.​pageintegerrequired
sortobject or null
filtersobject or null

Docs-only serializer exposing only the subset of filters for a platform.

curl -i -X POST \
  https://api-dashboard.influencers.club/public/v1/discovery/ \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "platform": "instagram",
    "paging": {
      "limit": 0,
      "page": 0
    },
    "sort": {
      "sort_by": "relevancy",
      "sort_order": "asc"
    },
    "filters": {
      "location": [
        "string"
      ],
      "type": "string",
      "gender": "string",
      "profile_language": [
        "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
      },
      "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"
      ],
      "last_post": "string",
      "income": {
        "min": 0.1,
        "max": 0.1
      },
      "exclude_keywords_in_bio": [
        "string"
      ],
      "keywords_in_captions": [
        "string"
      ],
      "link_in_bio": [
        "string"
      ],
      "hashtags": [
        "string"
      ],
      "not_hashtags": [
        "string"
      ],
      "brands": [
        "string"
      ],
      "has_videos": false,
      "has_merch": false,
      "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
      },
      "engagement_percent": {
        "min": 0.1,
        "max": 0.1
      }
    }
  }'

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": [
    { … }
  ]
}

Similar Creators

Operations

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