Skip to main content
POST
/tiktok/creative_center/ads/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
Required range: 1 <= x <= 20
timeout
integer
default:300
Required range: 20 <= x <= 1500
country
enum<string>
default:US
Available options:
AR,
AU,
BR,
CA,
CO,
FR,
DE,
ID,
IT,
JP,
MY,
MX,
NL,
PK,
PH,
RO,
SA,
SG,
ZA,
KR,
ES,
SE,
TH,
TR,
AE,
GB,
US,
VN
period
enum<string>
default:30
Available options:
7,
30,
180
order_by
enum<string>
default:for_you
Available options:
for_you,
impression,
ctr,
play_2s_rate,
play_6s_rate,
cvr,
like
industry
integer[] | null
objective
enum<string>[] | null
Available options:
1,
2,
3,
4,
5,
8,
15
ad_language
enum<string>[] | null
Available options:
en,
es,
ar,
vi,
th,
de,
id,
pt,
fr,
ms,
nl,
ja,
it,
ro,
zh-Hant,
ko
ad_format
enum<string> | null
Available options:
1,
2
like
enum<string> | null
Available options:
1,
2,
3,
4,
5

Response

Successful Response

id
string
required
@type
string
default:TikTokTopAd
brand
string | null
industry
string | null
objective
string | null
is_search
boolean | null
ctr
number | null
like_count
integer | null
budget
string | null
vid
string | null
duration
number | null
cover
string | null
video_url
string | null
width
integer | null
height
integer | null