v1

latestOpenAPI 3.0.32026-08-0670174396.8 KB
Creator Posts

Creator Posts

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.
<div class="ic-ai-prompt-root" data-endpoint="creator-posts"></div>
post/public/v1/creators/content/posts/

Request body

countinteger

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

pagination_tokenstring

Cursor for fetching the next page of results.

platformstring required

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

handlestring required

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

Example request

{
  "platform": "instagram",
  "handle": "creator_handle",
  "count": 12,
  "pagination_token": ""
}

Response

credits_costnumber double nullable

Example response

{
  "credits_cost": 0.03
}
All 70 operations