# 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.

Endpoint: POST /public/v1/creators/content/posts/
Version: 1.0.0
Security: Bearer

## Request fields (application/json):

  - `count` (integer)
    Number of posts to fetch per page. Clamped to platform-specific limits.

  - `pagination_token` (string)
    Cursor for fetching the next page of results.

  - `platform` (string, required)
    Social media platform. Allowed: instagram, tiktok, youtube.

  - `handle` (string, required)
    Creator identifier — username, profile URL, or YouTube channel ID (UC...).

## Response 200 fields (application/json):

  - `credits_cost` (number,null)

  - `result` (object, required)

  - `result.items` (array, required)

  - `result.items.pk` (string, required)

  - `result.items.taken_at` (integer,null)

  - `result.items.url` (string,null)

  - `result.items.device_timestamp` (integer,null)

  - `result.items.media_url` (string,null)

  - `result.items.media_id` (string,null)

  - `result.items.image_versions` (object, required)

  - `result.items.image_versions.candidates` (array)

  - `result.items.image_versions.candidates.width` (integer,null)

  - `result.items.image_versions.candidates.height` (integer,null)

  - `result.items.media_type` (integer, required)
    1 = Image, 2 = Video, 8 = Carousel

  - `result.items.user` (object, required)

  - `result.items.user.username` (string,null)

  - `result.items.user.full_name` (string,null)

  - `result.items.user.profile_pic_url` (string,null)

  - `result.items.engagement` (object, required)

  - `result.items.engagement.likes` (integer,null)

  - `result.items.engagement.comments` (integer,null)

  - `result.items.engagement.views` (integer,null)

  - `result.items.caption` (string,null)

  - `result.items.thumbnails` (object,null)

  - `result.num_results` (integer, required)

  - `result.more_available` (boolean, required)

  - `result.next_token` (string,null)

  - `result.status` (string)