TikTok Ads Library API: Get TikTok Top Ads suggestions

Returns brand and product keyword suggestions for query from Creative Center Top Ads. count (default 5, max 50) sets how many; country_codes and lang narrow and localize them.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

Brand or product text to get keyword suggestions for, for example a brand name.

Length1 <= length <= 200

count?integer

Maximum number of suggestions to return, 1 to 50.

Range1 <= value <= 50

Default5

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/suggestions?query=nike" \  -H "x-api-key: YOUR_API_KEY"

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