[中文]

用途:

获取特定关键词的详细数据，包括发布量、示例视频等

不提供关键词时，返回热门关键词排名列表

深入分析关键词的使用情况和效果

参数:

keyword: 关键词，可选。不提供时返回排名列表

page: 页码，默认1

limit: 每页数量，默认20

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

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

order_by: 排序字段，如"post"（发布量）

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

返回内容说明:

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_details",
  "params": {
    "keyword": "",
    "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"
          ]
        }
      ],
      "pagination": {
        "page": 1,
        "size": 20,
        "total": 484,
        "has_more": true
      }
    }
  }
}

[English]

Purpose:

Get detailed data for specific keywords, including post volume, example videos, etc.

When no keyword is provided, returns a ranked list of popular keywords

Deep analysis of keyword usage and effectiveness

Parameters:

keyword: Keyword, optional. Returns ranking list when not provided

page: Page number, default 1

limit: Items per page, default 20

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

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

order_by: Sort field, e.g., "post" (post volume)

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

Return Description:

keyword_list: Keyword details list

comment: Comment count

cost: Cost amount

cpa: Cost per acquisition

ctr: Click-through rate

cvr: Conversion rate

impression: Impression count

keyword: Keyword text

like: Like count

play_six_rate: 6-second play rate

post: Post volume

post_change: Post volume change rate

share: Share count

video_list: Video ID list

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_details",
  "params": {
    "keyword": "",
    "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"
          ]
        }
      ],
      "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 --request GET 'https://api.tikhub.io/api/v1/tiktok/ads/get_keyword_details?keyword&page&limit&period&country_code&order_by&order_type&industry&objective&keyword_type' \ --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 details

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response:

Request

Responses

获取关键词详细信息/Get keyword details

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request

Responses

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response: