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

Audience Overlap

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, Twitch games, audience brand categories, audience brand names, audience interests, and audience locations) 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

Connected Socials

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

Creator Posts

Operations

Creator Posts

Request

Fetch recent posts for a creator on a given platform.

What you get

  • Returns a list of recent posts with metadata including post ID, URL, caption, media URLs, timestamps, and engagement metrics (likes, comments, views, shares).
  • Supports Instagram, TikTok, and YouTube platforms.
  • Uses cursor-based pagination via next_token for fetching additional pages of results.
  • Page sizes are platform-specific:   Instagram — fixed at 12 posts per page (not configurable).   TikTok — default 30, max 35.   YouTube — default 30, max 50.

Credits

  • 0.03 credits per successful request. If no data is returned, no credits are deducted.
Security
Bearer
Body
required
countinteger

Number of posts to fetch per page. Clamped to platform-specific limits.

pagination_tokenstring

Cursor for fetching the next page of results.

platformstringnon-emptyrequired

Social media platform. Allowed: instagram, tiktok, youtube.

handlestringnon-emptyrequired

Creator identifier — username, profile URL, or YouTube channel ID (UC...).

curl -i -X POST \
  https://api-dashboard.influencers.club/public/v1/creators/content/posts/ \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "count": 0,
    "pagination_token": "string",
    "platform": "string",
    "handle": "string"
  }'

Responses

Bodyapplication/json
credits_costnumber or null
resultobject(CreatorPostsResult)required
result.​itemsArray of objects(PostItemModel)required
result.​items[].​pkstringrequired
result.​items[].​taken_atinteger or null
result.​items[].​urlstring or null
result.​items[].​device_timestampinteger or null
result.​items[].​media_urlstring or null
result.​items[].​media_idstring or null
result.​items[].​image_versionsobject(ImageVersionsModel)required
result.​items[].​image_versions.​candidatesArray of objects(MediaCandidateModel)
result.​items[].​media_typeintegerrequired

1 = Image, 2 = Video, 8 = Carousel

result.​items[].​userobject(UserInfoModel)required
result.​items[].​user.​pkstringrequired
result.​items[].​user.​usernamestring or null
result.​items[].​user.​full_namestring or null
result.​items[].​user.​profile_pic_urlstring or null
result.​items[].​engagementobject(EngagementModel)required
result.​items[].​engagement.​likesinteger or null
result.​items[].​engagement.​commentsinteger or null
result.​items[].​engagement.​viewsinteger or null
result.​items[].​captionstring or null
result.​items[].​thumbnailsobject or null
result.​num_resultsintegerrequired
result.​more_availablebooleanrequired
result.​next_tokenstring or nullnon-empty
result.​statusstringnon-empty
Default "ok"
Response
application/json
{
  "credits_cost": 0,
  "result": {
    "items": [ … ],
    "num_results": 0,
    "more_available": true,
    "next_token": "string",
    "status": "ok"
  }
}

Post Details

Operations

Account credits & usage

Account-level endpoints (credits, usage).

Operations