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

# Retrieve TikTok Top Ads detail

`GET /tiktok/top-ads/detail`

## Request

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

Returns detail for one TikTok Creative Center Top Ads material. Use `material_id`; the upstream does not accept `id` or `materialId`.

## Query parameters

- `material_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PopulartrendTopAdsDetailResponseDoc
  - `code` integer
  - `data` PopularTrendTopAdsDetailResp
    - `code` integer
    - `data` 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/028417aa35bb?raw)