Skip to main content
GET
cURL
2 creditsper request

Copy for AI

Why Code When AI Can Do It For You?

Stop writing code like it’s 1970! Let AI do the heavy lifting - click the button to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

Authorizations

Authorization
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx Get your API key from the Dashboard.

Query Parameters

page
integer
default:1

page number

limit
integer
default:20

MaxPerPage

Required range: 1 <= x <= 20
country_code
string

If omitted, all countries are included. Available values can be obtained from /v1/tk-ads/get_priority_region

Example:

"US,TH"

period
enum<integer>
default:30

Available values: 7=Last 7 Days, 30=Last 30 Days, 180=Last 180 Days

Available options:
7,
30,
180
order_by
enum<string>
default:for_you

Sort by, Available values: for_you = See relevant Top Ads that are selected for you based on your activity and business information. impression = The total number of users who viewed the video at least once. ctr = Click-through rate (CTR) is a ratio that shows the amount of viewers that clicked the ad to the total amount of viewers. It is calculated by dividing the number of clicks by the number of viewers. play_2s_rate = The number of views that were 2 seconds or longer divided by the total number of video views. play_6s_rate = The number of views that were 6 seconds or longer divided by the total number of video views. cvr = Conversion rate (CVR) measure the percentage of conversions created (such as follows, downloads, or purchases) at every second in the video. It is calculated by dividing the number of conversions by the number of interactions like = Likes

Available options:
for_you,
impression,
ctr,
play_2s_rate,
play_6s_rate,
cvr,
like
industry
string

Industry ID,Select from the industry ID list. If omitted, no industry filter is applied and all industries are included.

Example:

"27999000000,27103000000"

objective
string

Objective, If omitted, no campaign objective filter is applied and all objectives are included.Available values: 1=Traffic, 2=App Installs, 3=Conversions, 4=Video Views, 5=Reach, 8=Lead Generation, 15=Product Sales

Example:

"1,2,3,4"

ad_language
string

Ad Language, If omitted, no ad language filter is applied and all languages are included. Available values: en, es, ar, vi, th, de, id, pt, fr, ms, nl, ja, it, ro, zh-Hant, ko

Example:

"en,es,ar,vi,th"

ad_format
string

Ad Format, If omitted, no ad format filter is applied and all formats are included. Available values: 1=Spark Ads, 2=Non-Spark Ads

like
string

Likes, If omitted, no like count percentile filter is applied and all ranges are included. Available values: 1=Top 1–20%, 2=Top 21–40%, 3=Top 41–60%, 4=Top 61–80%, 5=Top 81–100%

Example:

"1,2,3,4,5"

Response

The response is of type object.