Skip to main content
GET
/
v1
/
tiktok
/
insights
/
ads
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/tiktok/insights/ads?search_keyword=FALSE&order_by=for_you&page=1&limit=20&period=7&region=nothing&industry=nothing&objective=nothing&ad_language=nothing&ad_format=nothing&like=nothing' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": {
    "materials": [
      {
        "ad_title": "หมดเก่งมาก",
        "brand_name": "",
        "cost": 2,
        "ctr": 0.89,
        "favorite": false,
        "id": "7599496668887564304",
        "industry_key": "label_23132000000",
        "is_search": true,
        "like": 58400,
        "objective_key": "campaign_objective_video_view",
        "tag": 2,
        "video_info": {
          "vid": "v29044g50000d4sn397og65m159dbpqg",
          "duration": 33.8,
          "cover": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-p-0037/oMaUBL5lEVpCYT7IcAPQ5cCd1ixAZiEBs2aIV~tplv-noop.image?dr=18692&refresh_token=754132a5&x-expires=1770134518&x-signature=Y2HoCVgbuaqkcxIQShxr1oNUYUM%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v29044g50000d4sn397og65m159dbpqg",
          "video_url": {
            "720p": "https://v16m-default.tiktokcdn.com/437306c551d75065fac84cd69e613e83/69821bf6/video/tos/alisg/tos-alisg-pve-0037c001/oQGT2QpiVYDaaBLEdVQ1l56FIQ7C5EExABPic/?a=0&bti=NTU4QDM1NGA%3D&ch=0&cr=0&dr=0&lr=tiktok_business&cd=0%7C0%7C0%7C0&cv=1&br=2456&bt=1228&cs=0&ds=3&ft=cApXJCz7ThWHEWo.1GZmo0P&mime_type=video_mp4&qs=0&rc=PDhoOTYzMzw6Zjk0NzhoZUBpanNnOHA5cjxxNzMzODczNUBeXzAwMDA2X2AxMi0wYGM1YSNuXzYuMmQ0MHBhLS1kMTZzcw%3D%3D&vvpl=1&l=202602031801244A1B2C464168A5C8DBB2&btag=e00088000"
          },
          "width": 576,
          "height": 1024
        }
      }
    ],
    "pagination": {
      "has_more": true,
      "page": 1,
      "size": 1,
      "total_count": 400
    }
  },
  "requestId": "9aa4d8b1-8ae8-4f6b-9c4c-3756f02bb020"
}
🪙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 sparkles 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

​
search_keyword
string
default:FALSE

Search keywords Value rule: FALSE (string type) = do not perform the search; non-empty string = perform the search according to the keyword

Example:

"FALSE"

​
order_by
string
default:for_you

Type (choose one option) Recommendation = for_you Exposure = impression Click-through rate = ctr 2-second completion rate = play_2s_rate 6-second completion rate = play_6s_rate CVR = cvr Number of likes = like

Example:

"for_you"

​
page
string
default:1

Pagination page number, used to specify the target page number of the query results

Example:

"1"

​
limit
string
default:20

The number of data items per page in pagination, which is used to specify the maximum number of results returned in a single query. The value range is 1 to 20. If it exceeds the maximum value, it will be automatically handled as 20.

Example:

"20"

​
period
string
default:7

Time range for querying data Optional valid values: 7 (last 7 days), 30 (last 30 days), 120 (last 120 days)

Example:

"7"

​
region
string
default:nothing

Country/region code, example: US

Example:

"nothing"

​
industry
string
default:nothing

Industry ID, which can be found in the Hot Trends - Industry Classification Mapping

Example:

"nothing"

​
objective
string
default:nothing

Delivery Targets (Optional) Default value "nothing" means no delivery target is selected. Number of visits = 1 App installations = 2 Conversions = 3 Video views = 4 Reach = 5 Lead generation = 8 Product sales = 14

Example:

"nothing"

​
ad_language
string
default:nothing

Advertising language (optional) The default value "nothing" means not selecting any advertising language. English = en Spanish = es Arabic = ar Vietnamese = vi Thai = th German = de Indonesian = id Portuguese = pt French = fr Malay = ms Dutch = n Japanese = ja Italian = it Romanian = ro Traditional Chinese = zh-Hant Korean = ko

Example:

"nothing"

​
ad_format
string
default:nothing

Ad style (choose one option) The default value "nothing" means not selecting any condition. Spark Ads = 1 Non-Spark Ads = 2

Example:

"nothing"

​
like
string
default:nothing

Number of likes (optional) The default value "nothing" means no condition is selected. Top 1-20% = 1 Top 21-40% = 2 Top 41-60% = 3 Top 61-80% = 4 Top 81-100% = 5

Example:

"nothing"

Response

Success

The response is of type object.