TikTok Creative Center API
TikTok Creative Center API
/tiktok-creative-center/v1/top_ads3 creditsHigh-performing auction ads by region / period / industry / objective, ranked. The core ad-spy feed (PiPiADS/Minea/AdSpy equivalent).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| region = US | optional | — | Two-letter country code to scope ads (US, GB, DE, JP, TR, BR…). Full supported list via the `locations` action / ad_filters.country. |
| period = 30 | optional | 7 · 30 · 180 | Trailing window the ad metrics are measured over (days). |
| order_by = for_you | optional | for_you · ctr · like · cost | Ranking. 'for_you' = TikTok's recommended single page (deep paging is limited); ctr/like/cost are metric sorts that paginate further. |
| industry | optional | 25000000000 · 24000000000 · 20000000000 · 16000000000 · 21000000000 · 23000000000 · 14000000000 | Industry id to filter by (numeric, e.g. 25000000000 = Games). Browse the full 258-entry taxonomy via the `ad_filters` action. |
| objective | optional | 1 · 2 · 3 · 4 · 5 · 8 · 15 | Campaign objective filter (id or name: Traffic, Conversions, App Installs, Video Views, Reach, Lead Generation, Product Sales). |
| ad_language | optional | — | Ad-language filter, e.g. language_en / language_es / language_de (see ad_filters.ad_language for the 16 supported values). |
| limit = 20 | optional | 1–20 | Ads to return per call (1-20; upstream caps a page at 20). Use `page` with order_by=ctr/like/cost for more. |
| page = 1 | optional | 1–50 | Result page (use order_by=ctr/like/cost to page beyond the first 'for_you' recommendation page). |
/tiktok-creative-center/v1/ad_detail3 creditsFull creative record for one ad: title, brand, ctr, landing page, matched keywords, objectives, highlight text, pattern labels, video renditions.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| ad_id | required | — | Creative/material id (the `id` field of a top_ads result). |
/tiktok-creative-center/v1/search_ads3 creditsKeyword search across the Top-Ads index (region/period scoped). Returns the same ad shape as top_ads. Note: only indexed terms return matches.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| keyword | required | — | Search term to match against the Top-Ads index. |
| region = US | optional | — | Two-letter country code to scope ads (US, GB, DE, JP, TR, BR…). Full supported list via the `locations` action / ad_filters.country. |
| period = 30 | optional | 7 · 30 · 180 | Trailing window the ad metrics are measured over (days). |
| limit = 20 | optional | 1–20 | Ads to return per call (1-20; upstream caps a page at 20). Use `page` with order_by=ctr/like/cost for more. |
| page = 1 | optional | 1–50 | Result page (use order_by=ctr/like/cost to page beyond the first 'for_you' recommendation page). |
/tiktok-creative-center/v1/ad_filters1 creditThe live filter taxonomy used by top_ads: full country (81), industry (258), objective (7), ad_language (16), pattern_label and period value lists.
Try in playground →/tiktok-creative-center/v1/query_suggestions1 creditTrending Top-Ads search suggestions (what advertisers are searching now).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| limit = 20 | optional | 1–50 | How many suggestions (1-50). |
/tiktok-creative-center/v1/trend_reports1 creditCreative-Center trend reports & creative-guidance articles (official TikTok marketing insight content).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| article_type = trends | optional | trends · guidance · 1 · 2 | Which Creative-Center article stream to return. |
| limit = 10 | optional | 1–50 | Articles (1-50). |
| page = 1 | optional | 1–50 | Result page (use order_by=ctr/like/cost to page beyond the first 'for_you' recommendation page). |
/tiktok-creative-center/v1/locations1 creditSupported country list for region scoping (id, country_code, country_name).
Try in playground →curl -X POST https://api.reefapi.com/tiktok-creative-center/v1/top_ads \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"region":"US","period":"30"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}