Skip to main content
POST
TikTok Creative Center Top Ads API

TikTok Creative Center Top Ads

Browse the TikTok ads that perform best, as ranked in TikTok Creative Center. Each ad comes with its caption, industry, campaign objective, click-through rate, likes and the full video, which makes the results a working swipe file for creative research. Add a query to focus on one product category or brand.
All fields are optional. query filters by keyword, time_range picks 7d, 30d (default) or 180d, and sort_by orders by relevance (default) or likes. results_limit defaults to 20 and accepts 1 to 300.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

All fields are optional. Returns top-performing TikTok ads with their click-through rate, likes and video; query narrows them by keyword. results_limit defaults to 20 and accepts 1 to 300.

callback_url
string<uri>
query
string

Optional keyword to match against ad captions and brands.

Minimum string length: 1
results_limit
integer
default:20
Required range: 1 <= x <= 300
sort_by
enum<string>
default:relevance

relevance for TikTok's own order, or likes for the most-liked ads first.

Available options:
likes,
relevance
Minimum string length: 1
time_range
enum<string>
default:30d

Period the ads ran in: 7d, 30d or 180d.

Available options:
180d,
30d,
7d
Minimum string length: 1

Response

Task accepted

code
integer
data
object