TikTok Ads Library API: Get TikTok ads search suggestions

Returns advertiser and keyword suggestions matching query from the Ads Library. suggest_type picks ads (advertisers and keywords) or reports (advertisers only). Use the advertiser ID in Search or Reports.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

Text to match against advertiser names and ad keywords, for example a brand name. Results come from the Ads Library.

Length1 <= length <= 200

suggest_type?string

Use ads for advertiser and keyword suggestions, or reports for advertiser-only suggestions.

Default"ads"

Value in

"ads"
"reports"

limit?integer

Maximum number of suggestions to request, 1 to 20.

Range1 <= value <= 20

Default20

curl -X GET "https://example.com/v1/tiktok-ads/suggestions?query=shoe" \  -H "x-api-key: YOUR_API_KEY"

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