---
title: "Get Top Ads"
method: GET
path: "/api/trending/ads"
tags: ["Trending"]
---

# Get Top Ads

`GET /api/trending/ads`

Get Top Ads

## Query parameters

- `page` integer — Page
- `period` 7 | 30 | 180 — Period in days: - 7: Last 7 days - 30: Last 30 days - 180: Last 180 days
- `limit` integer — Number of items per page (maximum is 20)
- `country` string — Country code. Head [here](https://gist.githubusercontent.com/apiboxguru/21d1cff1bef7732d9533389cb540541f/raw/6669d1e0025b67e8c7a0a1649cd8c75c5d5d2803/tiktok_trending_support_countries_with_codes.json) for a full list of supported countries
- `order_by` 'impression' | 'ctr' | 'like' | 'cvr' | 'play_6s_rate' | 'play_2s_rate' — 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
- `industry` string — Head to [here](https://gist.githubusercontent.com/apiboxguru/d36908ea2bbe307e81bcc09ccf59616b/raw/302b5a442df9a6efced1dc430fd64d10a8226aeb/tiktok-ads-industry-code.json) 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
- `keyword` string — Search ads keyword

## Response `200`

Success

- object
  - `data` object
    - `pagination` object
      - `has_more` boolean
      - `page` number
      - `size` number
      - `total_count` number
    - `materials` object[]
      - `ad_title` string
      - `brand_name` string
      - `cost` number
      - `ctr` number
      - `favorite` boolean
      - `id` string
      - `industry_key` string
      - `is_search` boolean
      - `like` number
      - `objective_key` string
      - `video_info` object
        - `vid` string
        - `duration` number
        - `cover` string
        - `video_url` object
          - `720p` string
        - `width` number
        - `height` number

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/tikfly/apis/tikfly-api-unoffical-tiktok-api.md) · [All operations](https://skmtc.net/tikfly/apis/tikfly-api-unoffical-tiktok-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tikfly/tikfly-api-unoffical-tiktok-api/versions/892e18b9f5af/schema)