UnifAPI Docs

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.

GET
/tiktok/ads/search

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

q?string

Search keyword

Length1 <= length <= 100
period?string

Ranking window: last 7, 30, or 180 days.

Default"7d"

Value in

  • "7d"
  • "30d"
  • "180d"
country?string

Comma-separated region codes where the ad ran, e.g. US,DE.

Match^[A-Za-z]{2}(,[A-Za-z]{2})*$
language?string

Comma-separated ad language codes, e.g. en,de or zh-Hant.

Match^[A-Za-z]{2}(-[A-Za-z]{2,4})?(,[A-Za-z]{2}(-[A-Za-z]{2,4})?)*$
sort_by?string

Ranking metric: reach (impressions), CTR, likes, CVR, or 6s/2s view rate.

Default"impressions"

Value in

  • "impressions"
  • "ctr"
  • "likes"
  • "cvr"
  • "play_6s_rate"
  • "play_2s_rate"
industry?string

Comma-separated TikTok Creative Center industry codes, e.g. 28000000000.

Match^\d+(,\d+)*$
objective?string

Comma-separated campaign objectives: traffic, app_installs, conversions, video_views, reach, lead_generation, product_sales.

ad_format?string

spark returns Spark Ads (boosted organic posts) only; non_spark the rest.

Value in

  • "spark"
  • "non_spark"
like_percentile?string

Only return ads whose like count ranks in this top-percent band.

Value in

  • "1-20"
  • "21-40"
  • "41-60"
  • "61-80"
  • "81-100"
cursor?string
limit?integer
Range1 <= value <= 20
Default20

Header Parameters

Unifapi-Version?"2026-07-01"

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

Default"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  }}