API

Creatives API

Name: Mostly
Rating: 4.8 (150 reviews)

Search winning competitor ads, viral outliers, and indexed creative libraries.

Search Mostly's proprietary database of indexed competitor ads, winning TikTok/Meta creatives, and viral outliers.

Search Creatives

HTTP

GET /api/v1/creatives

Request Headers

Header	Type	Description
`Authorization`	`string`	`Bearer mst_live_...` (Required)

Query Parameters

Parameter	Type	Default	Description
`query`	`string`	`null`	Keyword filter matching ad captions, transcripts, and creator handles.
`platform`	`string`	`null`	Filter by platform: `META`, `TIKTOK`, `INSTAGRAM`, `YOUTUBE`, or `X`.
`isViralOutlier`	`boolean`	`null`	When set to `true`, only returns posts exceeding median benchmark view counts.
`limit`	`number`	`20`	Number of results to return (Min: 1, Max: 50).
`offset`	`number`	`0`	Pagination offset.

Example Request

Terminal

curl -X GET "https://mostly.so/api/v1/creatives?query=skincare&isViralOutlier=true&limit=2" \
  -H "Authorization: Bearer mst_live_abc123..."

Example Response (`200 OK`)

JSON

{
  "total": 2,
  "limit": 2,
  "offset": 0,
  "creatives": [
    {
      "id": "c_9f8a123b-4567-89ab-cdef-0123456789ab",
      "caption": "Stop making this 1 huge mistake with your morning serum routine...",
      "authorName": "Glow Labs",
      "authorHandle": "@glowlabs",
      "platform": "TIKTOK",
      "sourceType": "PAID",
      "viewCount": 2400000,
      "isViralOutlier": true,
      "outlierMultiplier": 6.8,
      "thumbnailUrl": "https://pub-r2.mostly.so/thumbnails/thumb_123.webp",
      "mediaUrl": "https://pub-r2.mostly.so/videos/vid_123.mp4",
      "publishedAt": "2026-09-20T14:32:00.000Z"
    },
    {
      "id": "c_1a2b3c4d-5678-90ef-ghij-1234567890cd",
      "caption": "Why dermatologist-tested doesn't mean what you think it means.",
      "authorName": "Derm Insights",
      "authorHandle": "@derminsights",
      "platform": "META",
      "sourceType": "PAID",
      "viewCount": 850000,
      "isViralOutlier": true,
      "outlierMultiplier": 3.4,
      "thumbnailUrl": "https://pub-r2.mostly.so/thumbnails/thumb_124.webp",
      "mediaUrl": "https://pub-r2.mostly.so/videos/vid_124.mp4",
      "publishedAt": "2026-09-22T09:15:00.000Z"
    }
  ]
}

Response Fields

Field	Type	Description
`id`	`string`	Unique creative identifier.
`caption`	`string`	Primary ad caption or social hook text.
`authorName`	`string`	Brand page or creator display name.
`authorHandle`	`string`	Social account handle (e.g. `@glowlabs`).
`platform`	`string`	Platform where the ad ran (`META`, `TIKTOK`, `INSTAGRAM`, etc.).
`sourceType`	`string`	Ad classification: `PAID` (Meta/TikTok Ads Archive) or `ORGANIC`.
`viewCount`	`number`	Total recorded views or impression tier.
`isViralOutlier`	`boolean`	Indicates whether the post achieved outlier virality status.
`outlierMultiplier`	`number`	Multiplier versus the account's historical median view count.
`thumbnailUrl`	`string`	Direct URL to the high-resolution poster image.
`mediaUrl`	`string`	Direct streaming URL for the video or image asset.
`publishedAt`	`string`	ISO 8601 timestamp when the ad was first launched.