List Creatives

GET /api/v1/creatives/list

Returns the creatives you've generated, most recent first. Supports optional filters.

Query parameters

Param	Type	Description
`platform`	string	Filter by target platform (`instagram`, `tiktok`, `youtube`, `linkedin`, ...)
`type`	string	Filter by creative type (`image`, `video`, `carousel`, `story`)
`limit`	number	Page size (default 20, max 100)
`cursor`	string	Pagination cursor returned by the previous page

Response

{
  "data": [
    {
      "id": "crv_xxx",
      "platform": "instagram",
      "type": "image",
      "textContent": "Meet the Super Widget — the last tool you'll ever need. 🛠️",
      "mediaUrl": "https://cdn.pepe.business/creatives/crv_xxx_ig.jpg",
      "hashtags": ["#superwidget", "#shopsmall"],
      "ctaText": "Shop now → link in bio",
      "framework": "product_highlight",
      "placeholder": false,
      "sourceUrl": "https://my-shop.com/products/super-widget",
      "createdAt": "2026-08-11T10:00:00Z"
    }
  ],
  "nextCursor": "eyJjcmVhdGVkQXQiOjE..."
}

Example

curl "https://pepe.business/api/v1/creatives/list?platform=tiktok&type=video&limit=50" \
  -H "Authorization: Bearer pk_live_xxx"