TikTok

TikTok Ad Library Search

Search ads running on TikTok by keyword, industry and country - each ad's title, brand, campaign objective, click-through rate, likes and video cover, with pagination. Provide a keyword or an industry. Costs 1 credit per call.

POST/api/v1/tiktok/ads/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

keywordstring

Keyword to match ad copy and creative by. Provide keyword or industry.

Example: nike

industrystring

Restrict results to a single industry, by its industry key. Provide keyword or industry.

Example: label_22108000000

countrystring

Two-letter country the ad ran in. Defaults to US.

Example: US

objectivestring

Restrict to ads with a given campaign objective.

ad_formatstring

Restrict to a given ad format.

periodenum<number>default:180

Lookback window in days.

7 — Ads from the last 7 days.
30 — Ads from the last 30 days.
180 — Ads from the last 180 days. The default.

order_bystring

Result ordering.

Example: for_you

pagenumberdefault:1

Page number (1-100).

limitnumberdefault:20

Results per page (1-50).

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.tiktok.ads_search(keyword="nike", country="US")
print(results)

Response

"response_time": 1434,

"credits_used": 1,

"credits_remaining": 4573

}