v1

latestOpenAPI 3.1.02026-07-26560790.7 KB

Trending

Get Top Ads

get/api/trending/ads

Query parameters

pageinteger

Page

Example:1

period7 | 30 | 180

    Period in days:
    - 7: Last 7 days
    - 30: Last 30 days
    - 180: Last 180 days

Example:30

limitinteger

Number of items per page (maximum is 20)

Example:20

countrystring

Country code. Head here for a full list of supported countries

Example:US

    Order by:
    - impression: Reach
    - ctr: CTR
    - like: Like
    - cvr: CRV
    - play_6s_rate: 6s view rate
    - play_2s_rate: 2s view rate

like'1' | '2' | '3' | '4' | '5'

    Likes:
    - 1: Top 1~20%
    - 2: Top 21~40%
    - 3: Top 41~60%
    - 4: Top 61~80%
    - 5: Top 81~100%

ad_format'1' | '2'

    Ad Format:
    - 1: Spark Ads
    - 2: Non-spark Ads

objective'1' | '2' | '3' | '4' | '5' | '6' | '7'

    Objective:
    - 1: Traffic
    - 2: App installs
    - 3: Conversions
    - 4: Video views
    - 5: Reach
    - 6: Lead generation
    - 7: Product sales

industrystring

Head to here for a full list of Industry code. You can combine multiple industries by using a comma. For example: 22102000000,22101000000

ad_language'en' | 'es' | 'ar' | 'vi' | 'th' | 'de' | 'id' | 'pt' | 'fr' | 'ms' | 'nl' | 'ja' | 'it' | 'ro' | 'zh-Hant' | 'ko'

Ads language. Supported language: en, es, ar, vi, th, de, id, pt, fr, ms, nl, ja, it, ro, zh-Hant, ko

keywordstring

Search ads keyword

Response

Success

Example response

{
  "data": {
    "pagination": {
      "has_more": true,
      "page": 1,
      "size": 20,
      "total_count": 500
    },
    "materials": [
      {
        "ad_title": "Save 25% at Target",
        "brand_name": "HotWheelsLetsRace",
        "cost": 1,
        "ctr": 0.01,
        "id": "7574848560483926024",
        "industry_key": "label_30102000000",
        "is_search": true,
        "like": 154,
        "objective_key": "campaign_objective_traffic",
        "video_info": {
          "vid": "v10033g50000d4fk9ovog65ppa0pi800",
          "duration": 15.034,
          "cover": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-p-0051c001-sg/o8KC0QYjfzpAAyHRQ4EtBFHDNBPDlgTQMIfQyQ~tplv-noop.image?dr=18692&refresh_token=ce06c89b&x-expires=1765827974&x-signature=9M68jwl7ZTSjpRAJf2CnvoUxBpM%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my",
          "video_url": {
            "720p": "https://v16m-default.tiktokcdn.com/8b4cc8c593174434cd367fd6d9582ada/69405cc1/video/tos/alisg/tos-alisg-ve-0051c001-sg/okqGXQ0MAhRCJ0nW8XRbDAAlgxqefUR3NB3aeg/?a=0&bti=NTU4QDM1NGA%3D&ch=0&cr=0&dr=0&lr=tiktok_business&cd=0%7C0%7C1%7C0&cv=1&br=1570&bt=785&cs=0&ds=3&ft=cApXJCz7ThWHrs0-1GZmo0P&mime_type=video_mp4&qs=0&rc=ZDs2aDs6N2loZThlPDU7O0BpanI8Nm45cjM5NTMzODYzNEBiLjBhXzI1XjUxNi9jMF9hYSNiZ3BrMmQ0cWhhLS1kMC1zcw%3D%3D&vvpl=1&l=20251215210804481E21104311144D334E&btag=e00088000"
          },
          "width": 576,
          "height": 1024
        }
      }
    ]
  }
}