---
title: "Retrieve TikTok Top Ads recommendations"
method: GET
path: "/tiktok/top-ads/recommend"
tags: ["TikTok", "TikTok Top Ads"]
---

# Retrieve TikTok Top Ads recommendations

`GET /tiktok/top-ads/recommend`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tiktok/top-ads/recommend`
- Auth: API key in header `x-api-key`

Lists Top Ads materials that TikTok Creative Center recommends as related to the ad with `material_id`. `page` starts at 1; `limit` defaults to 20 and is capped at 100. Each ad has its title, brand, likes, comments, shares, CTR, objectives and video info. The list can be empty for a valid id.

## Query parameters

- `material_id` string, required
- `page` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PopulartrendTopAdsRecommendResponseDoc
  - `code` integer
  - `data` PopularTrendTopAdsRecommendResp
    - `code` integer
    - `data` object: Ads related to the requested ad.
      - `materials` PopularTrendTopAdsMaterial[]
        - `ad_title` string: Title of the ad.
        - `brand_name` string: Name of the advertiser brand.
        - `comment` integer: Number of comments on the ad.
        - `cost` integer: Cost figure for the ad as TikTok Creative Center reports it.
        - `country_code` string[]: Country codes the ad runs in.
        - `ctr` number: Click-through rate of the ad as TikTok Creative Center reports it.
        - `favorite` boolean: Whether the ad is marked as a favorite.
        - `has_summary` boolean: Whether TikTok has an ad summary available for the ad.
        - `highlight` string: Highlight note TikTok attaches to the ad.
        - `highlight_text` string: Text shown for the ad's highlight.
        - `id` string: Top Ads material id. Use it with the detail, analysis and recommend endpoints.
        - `industry_key` string: Key of the industry the ad is classified under.
        - `is_search` boolean: Search flag TikTok sets on the ad.
        - `keyword_list` string[]: Keywords associated with the ad.
        - `landing_page` string: URL of the ad's landing page.
        - `like` integer: Number of likes on the ad.
        - `objective_key` string: Key of the campaign objective of the ad.
        - `objectives` PopularTrendTopAdsFilterItem[]: Campaign objectives of the ad, each with its id, value and label.
          - `has_conversion` boolean: Whether the objective is one that tracks conversions. Only set on objective options.
          - `id` object: Filter option id in TikTok's own format, a string or a number depending on the filter.
          - `label` string: Label key TikTok uses for the option.
          - `parent_id` object: Id of the parent option, for example the top-level industry of a sub-industry.
          - `value` string: Display value of the option, always returned as a string.
        - `pattern_label` PopularTrendTopAdsFilterItem[]: Creative pattern labels assigned to the ad.
          - `has_conversion` boolean: Whether the objective is one that tracks conversions. Only set on objective options.
          - `id` object: Filter option id in TikTok's own format, a string or a number depending on the filter.
          - `label` string: Label key TikTok uses for the option.
          - `parent_id` object: Id of the parent option, for example the top-level industry of a sub-industry.
          - `value` string: Display value of the option, always returned as a string.
        - `share` integer: Number of shares of the ad.
        - `source` string: Source label of the ad as TikTok Creative Center shows it.
        - `source_key` integer: Numeric key of the ad's source.
        - `video_info` PopularTrendTopAdsVideoInfo
          - `cover` string: URL of the video cover image.
          - `duration` number: Video length in seconds.
          - `height` integer: Video height as TikTok reports it.
          - `vid` string: TikTok video id.
          - `video_url` object: Video file URLs keyed by resolution label, for example `720p`.
          - `width` integer: Video width as TikTok reports it.
        - `voice_over` boolean: Whether the ad video has a voice-over.
    - `msg` string
    - `request_id` string: Request id returned by TikTok Creative Center.
  - `msg` string

## Other responses

- `400`: Invalid input
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)