Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
number
default:1
required

Requested page. Use this for pagination. 20 ads per page.

period
number
required

Period in days: 7 | 30 | 180

country
string

Two letter Country code. Example: US. To get the full list of country use this endpoint: Get Social Country List

order_by
string
required

Possible options: ctr | impression | like | cvr | play_6s_rate | play_2s_rate

ad_type
string

Possible options: spark_ads | non_spark_ads

goal
string

Possible options: traffic | app_installs | conversions | video_views | reach | lead_generation | product_sales

ad_categories
string

You can combine multiple categories by using a comma. For example: 22102000000,22101000000 To get the full list of TikTok Categories use this endpoint: Get TikTok Category List

ad_language
string

Possible options: en es ar vi th de id pt fr ms nl ja it ro zh-Hant ko

keyword
string

Search ads by keyword

performance
string

Possible options: top_20 | top_40 | top_60 | top_80 | top_100

api_key
string
required

This is your account API Key. You can easily locate it in your account dashboard.

Response

200

OK