[中文]

用途:

获取TikTok广告关键词洞察数据，了解热门关键词的表现指标

分析不同关键词的点击率、发布量、增长趋势等核心数据

帮助广告主优化关键词策略，提升广告投放效果

参数:

page: 页码，默认1

limit: 每页数量，默认20

period: 时间范围（天），如7、30、120天

country_code: 国家代码，如US、UK、JP等

order_by: 排序字段，可选：post（发布量）、ctr（点击率）、click_rate（点击率）、trend（趋势）

order_type: 排序方式，desc（降序）或asc（升序）

industry: 行业ID，多个用逗号分隔

objective: 广告目标

keyword_type: 关键词类型

返回内容说明:

keyword_list: 关键词列表

comment: 评论数

cost: 花费金额

cpa: 每次转化成本

ctr: 点击率（百分比）

cvr: 转化率（百分比）

impression: 展示量

keyword: 关键词文本

like: 点赞数

play_six_rate: 6秒播放率（百分比）

post: 发布量

post_change: 发布量变化率（百分比）

share: 分享数

video_list: 视频ID列表

pagination: 分页信息

page: 当前页

size: 每页数量

total: 总数量

has_more: 是否有更多

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_keyword_insights",
  "params": {
    "page": "1",
    "limit": "20",
    "period": "7",
    "country_code": "US",
    "order_by": "post",
    "order_type": "desc"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "keyword_list": [
        {
          "comment": 4785,
          "cost": 756000,
          "cpa": 20.2,
          "ctr": 0.53,
          "cvr": 9.75,
          "impression": 164000000,
          "keyword": "summer",
          "like": 475734,
          "play_six_rate": 6.43,
          "post": 14200,
          "post_change": 111.21,
          "share": 5754,
          "video_list": [
            "7504060523021896977",
            "7512164952346529031",
            "7511370341621435679",
            "7511483560939785514",
            "7506971390613015854"
          ]
        },
        {
          "comment": 2151,
          "cost": 264000,
          "cpa": 17.8,
          "ctr": 1.38,
          "cvr": 6.15,
          "impression": 38100000,
          "keyword": "free shipping",
          "like": 84131,
          "play_six_rate": 8.64,
          "post": 7810,
          "post_change": 91.91,
          "share": 3707,
          "video_list": [
            "7471433861654727943",
            "7515178617568070930",
            "7502578466194312456",
            "7513186274711244054",
            "7514776490123201810"
          ]
        }
      ],
      "pagination": {
        "page": 1,
        "size": 20,
        "total": 484,
        "has_more": true
      }
    }
  }
}

[English]

Purpose:

Get TikTok ad keyword insights data to understand performance metrics of popular keywords

Analyze CTR, post volume, growth trends and other core data for different keywords

Help advertisers optimize keyword strategies and improve ad delivery effectiveness

Parameters:

page: Page number, default 1

limit: Items per page, default 20

period: Time period in days, e.g., 7, 30, 120 days

country_code: Country code, e.g., US, UK, JP

order_by: Sort field, options: post (post volume), ctr (click-through rate), click_rate, trend

order_type: Sort order, desc (descending) or asc (ascending)

industry: Industry IDs, multiple separated by commas

objective: Ad objectives

keyword_type: Keyword type

Return Description:

keyword_list: List of keywords

comment: Comment count

cost: Cost amount

cpa: Cost per acquisition

ctr: Click-through rate (percentage)

cvr: Conversion rate (percentage)

impression: Impression count

keyword: Keyword text

like: Like count

play_six_rate: 6-second play rate (percentage)

post: Post volume

post_change: Post volume change rate (percentage)

share: Share count

video_list: List of video IDs

pagination: Pagination info

page: Current page

size: Items per page

total: Total count

has_more: Whether there are more items

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_keyword_insights",
  "params": {
    "page": "1",
    "limit": "20",
    "period": "7",
    "country_code": "US",
    "order_by": "post",
    "order_type": "desc"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "keyword_list": [
        {
          "comment": 4785,
          "cost": 756000,
          "cpa": 20.2,
          "ctr": 0.53,
          "cvr": 9.75,
          "impression": 164000000,
          "keyword": "summer",
          "like": 475734,
          "play_six_rate": 6.43,
          "post": 14200,
          "post_change": 111.21,
          "share": 5754,
          "video_list": [
            "7504060523021896977",
            "7512164952346529031",
            "7511370341621435679",
            "7511483560939785514",
            "7506971390613015854"
          ]
        },
        {
          "comment": 2151,
          "cost": 264000,
          "cpa": 17.8,
          "ctr": 1.38,
          "cvr": 6.15,
          "impression": 38100000,
          "keyword": "free shipping",
          "like": 84131,
          "play_six_rate": 8.64,
          "post": 7810,
          "post_change": 91.91,
          "share": 3707,
          "video_list": [
            "7471433861654727943",
            "7515178617568070930",
            "7502578466194312456",
            "7513186274711244054",
            "7514776490123201810"
          ]
        }
      ],
      "pagination": {
        "page": 1,
        "size": 20,
        "total": 484,
        "has_more": true
      }
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.tikhub.io/api/v1/tiktok/ads/get_keyword_insights?page=undefined&limit=undefined&period=undefined&country_code=undefined&order_by=undefined&order_type=undefined&industry=undefined&objective=undefined&keyword_type=undefined&keyword=undefined' \ --header 'Authorization: Bearer <token>'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

获取关键词洞察数据/Get keyword insights data

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response:

Request

Responses

获取关键词洞察数据/Get keyword insights data

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request

Responses

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response: