跳转到主要内容
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 credits每次请求

​
Copy for AI

🤖 让 AI 帮你写调用代码

点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。

授权

​
Authorization
string
header
必填

接口鉴权凭证。请在请求 Header 中传入 Authorization: Bearer <YOUR_API_KEY>。 可在 Dashboard 获取你的 API Key。

查询参数

​
search_keyword
string
默认值:FALSE

搜索关键词；传 FALSE 字符串表示不搜索，传非空字符串时按关键词搜索。

示例:

"FALSE"

​
order_by
string
默认值:for_you

排序或指标类型，选择一个值：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。

示例:

"for_you"

​
page
string
默认值:1

分页页码，用于指定查询结果的目标页。

示例:

"1"

​
limit
string
默认值:20

每页返回数量，取值范围 1 到 20；超过最大值时会按 20 处理。

示例:

"20"

​
period
string
默认值:7

查询时间范围，可选值：7=近 7 天，30=近 30 天，120=近 120 天。

示例:

"7"

​
region
string
默认值:nothing

国家/地区代码，例如 US。

示例:

"nothing"

​
industry
string
默认值:nothing

行业 ID，可从热门趋势的行业分类映射中获取。

示例:

"nothing"

​
objective
string
默认值:nothing

投放目标，可选；默认值 nothing 表示不选择投放目标。Number of visits=1，App installations=2，Conversions=3，Video views=4，Reach=5，Lead generation=8，Product sales=14。

示例:

"nothing"

​
ad_language
string
默认值:nothing

广告语言，可选；默认值 nothing 表示不选择广告语言。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。

示例:

"nothing"

​
ad_format
string
默认值:nothing

广告样式，选择一个值；默认值 nothing 表示不筛选。Spark Ads=1，Non-Spark Ads=2。

示例:

"nothing"

​
like
string
默认值:nothing

点赞数分位筛选，可选；默认值 nothing 表示不筛选。Top 1-20%=1，Top 21-40%=2，Top 41-60%=3，Top 61-80%=4，Top 81-100%=5。

示例:

"nothing"

响应

请求成功

The response is of type object.