Search top TikTok ads
Returns top-performing TikTok ads from TikTok Creative Center, ranked by reach, CTR, likes, CVR, or view rate over the last 7, 30, or 180 days. Filter by keyword, region, language, industry, objective, format, and like percentile. Use `next_cursor` from the response as the next request's `cursor`.
Pricing — $ · min $0.001
Billed per record at 1 credit ($0.001) each, with a 1-credit ($0.001) minimum per call.
Authorization
bearerAuth UnifAPI API key. Provider credentials are managed by UnifAPI.
In: header
Query Parameters
Search keyword
1 <= length <= 100Ranking window: last 7, 30, or 180 days.
"7d"Value in
- "7d"
- "30d"
- "180d"
Comma-separated region codes where the ad ran, e.g. US,DE.
^[A-Za-z]{2}(,[A-Za-z]{2})*$Comma-separated ad language codes, e.g. en,de or zh-Hant.
^[A-Za-z]{2}(-[A-Za-z]{2,4})?(,[A-Za-z]{2}(-[A-Za-z]{2,4})?)*$Ranking metric: reach (impressions), CTR, likes, CVR, or 6s/2s view rate.
"impressions"Value in
- "impressions"
- "ctr"
- "likes"
- "cvr"
- "play_6s_rate"
- "play_2s_rate"
Comma-separated TikTok Creative Center industry codes, e.g. 28000000000.
^\d+(,\d+)*$Comma-separated campaign objectives: traffic, app_installs, conversions, video_views, reach, lead_generation, product_sales.
spark returns Spark Ads (boosted organic posts) only; non_spark the rest.
Value in
- "spark"
- "non_spark"
Only return ads whose like count ranks in this top-percent band.
Value in
- "1-20"
- "21-40"
- "41-60"
- "61-80"
- "81-100"
1 <= value <= 2020Header Parameters
Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md
"2026-07-01"Value in
- "2026-07-01"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/tiktok/ads/search"{ "request_id": "string", "data": [ { "id": "string", "title": "string", "brand_name": "string", "industry_key": "string", "objective_key": "string", "ctr": 0, "like_count": 0, "comment_count": 0, "share_count": 0, "budget_level": 0, "country_codes": [ "string" ], "keywords": [ "string" ], "landing_page_url": "string", "source": "string", "video": { "id": "string", "duration": 0, "cover_image_url": "string", "play_url": "string", "width": 0, "height": 0 } } ], "pagination": { "has_more": true, "next_cursor": "string" }, "billing": { "credits_charged": 0, "records_charged": 0, "balance_remaining": 0, "truncated_due_to_balance": true }}