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

# Retrieve TikTok Top Ads locations

`GET /tiktok/top-ads/locations`

## Request

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

Lists the country filters offered by TikTok Creative Center Top Ads. Each country has an `id` such as `US`, a `value` (the country name), a `label` and a `has_conversion` flag. Takes no parameters.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PopulartrendTopAdsLocationsResponseDoc
  - `code` integer
  - `data` PopularTrendTopAdsLocationsResp
    - `code` integer
    - `data` object: Countries available for top ads targeting.
      - `country` PopularTrendTopAdsFilterItem[]
        - `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.
    - `msg` string
    - `request_id` string: Request id returned by TikTok Creative Center.
  - `msg` string

## Other responses

- `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)