TikTok Ads Library API: List related TikTok Top Ads

Returns Top Ads related to material_id. Requires the ad's full numeric industry_id and comma-separated country_codes; lang sets the display language.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

material_id*string

Top Ads material ID from the Top Ads List or Spotlight response.

Match^\d+$

Lengthlength <= 40

industry_id*string

Full numeric industry ID of the selected Top Ad, such as one from the Top Ads Filters response.

Match^\d+$

Lengthlength <= 20

country_codes*string

ALL or one or more comma-separated country codes returned by the Top Ads filters route.

Match^(?:[Aa][Ll][Ll]|[A-Za-z]{2}(?:,[A-Za-z]{2})*)$

Lengthlength <= 100

lang?string

Creative Center display language. Defaults to English.

Default"en"

Value in

"en"
"ja"
"zh"
"vi"
"th"
"pt"
"id"

curl -X GET "https://example.com/v1/tiktok-ads/top-ads/recommendations?material_id=7631262985109602311&industry_id=23110000000&country_codes=NL%2CAR" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "property1": null,    "property2": null  }}