Skip to content

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.

Example:12
pagination_tokenstring

Cursor for fetching the next page of results.

Example:""
platformstringrequired

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

Example:"instagram"
handlestringrequired

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

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

Responses

Bodyapplication/json
credits_costnumber or null, (double)
Example:0.03
resultobject(CreatorPostsResult)required
Response
{
  "credits_cost": 0.03,
  "result": {
    "items": [ … ],
    "num_results": 0,
    "more_available": true,
    "next_token": "string",
    "status": "ok"
  }
}