[中文]

用途:

获取指定时间段内的流行趋势视频

了解当前热门内容的特点和趋势

为广告创意提供灵感和参考

参数:

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

page: 页码，默认1

limit: 每页数量，默认10

order_by: 排序字段

vv: 按观看量排序

like: 按点赞数排序

comment: 按评论数排序

repost: 按转发数排序

country_code: 国家代码

返回内容说明:

pagination: 分页信息

has_more: 是否有更多

limit: 每页数量

page: 当前页

total_count: 总数量

videos: 趋势视频列表

country_code: 国家代码

cover: 封面图URL

duration: 时长（秒）

id: 视频ID

item_id: 视频项目ID

item_url: 视频链接

region: 地区

title: 视频标题

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_popular_trends",
  "params": {
    "period": "7",
    "page": "1",
    "limit": "10",
    "order_by": "vv",
    "country_code": "US"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "pagination": {
        "has_more": true,
        "limit": 10,
        "page": 1,
        "total_count": 500
      },
      "videos": [
        {
          "country_code": "US",
          "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/osAmHI2QkEfCyjJI57DfCFPhVDQJqnImEusfHA~tplv-noop.image",
          "duration": 15,
          "id": "7512918118663081262",
          "item_id": "7512918118663081262",
          "item_url": "https://www.tiktok.com/@mnm_pipi/video/7512918118663081262",
          "region": "United States",
          "title": "We've lowered MSRP on Rogue and Pathfinder, because Nissan is here for you."
        },
        {
          "country_code": "US",
          "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/ocQjW3QOfqt0seM0CA8gWfAqC5I2BO1LIkjQUI~tplv-noop.image",
          "duration": 15,
          "id": "7514018454932835615",
          "item_id": "7514018454932835615",
          "item_url": "https://www.tiktok.com/@mnm_pipi/video/7514018454932835615",
          "region": "United States",
          "title": "Wanna see something gorgeous? Apple's new look is coming soon. Learn more at www.apple.com/os/. #LiquidGlass #WWDC25 #Apple #iOS26 #macOS26"
        }
      ]
    }
  }
}

[English]

Purpose:

Get popular trend videos for specified time period

Understand characteristics and trends of current hot content

Provide inspiration and reference for ad creativity

Parameters:

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

page: Page number, default 1

limit: Items per page, default 10

order_by: Sort field

vv: Sort by view count

like: Sort by like count

comment: Sort by comment count

repost: Sort by repost count

country_code: Country code

Return Description:

pagination: Pagination info

has_more: Has more pages

limit: Items per page

page: Current page

total_count: Total count

videos: Trend video list

country_code: Country code

cover: Cover image URL

duration: Duration in seconds

id: Video ID

item_id: Video item ID

item_url: Video link

region: Region name

title: Video title

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_popular_trends",
  "params": {
    "period": "7",
    "page": "1",
    "limit": "10",
    "order_by": "vv",
    "country_code": "US"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "pagination": {
        "has_more": true,
        "limit": 10,
        "page": 1,
        "total_count": 500
      },
      "videos": [
        {
          "country_code": "US",
          "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/osAmHI2QkEfCyjJI57DfCFPhVDQJqnImEusfHA~tplv-noop.image",
          "duration": 15,
          "id": "7512918118663081262",
          "item_id": "7512918118663081262",
          "item_url": "https://www.tiktok.com/@mnm_pipi/video/7512918118663081262",
          "region": "United States",
          "title": "We've lowered MSRP on Rogue and Pathfinder, because Nissan is here for you."
        },
        {
          "country_code": "US",
          "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/ocQjW3QOfqt0seM0CA8gWfAqC5I2BO1LIkjQUI~tplv-noop.image",
          "duration": 15,
          "id": "7514018454932835615",
          "item_id": "7514018454932835615",
          "item_url": "https://www.tiktok.com/@mnm_pipi/video/7514018454932835615",
          "region": "United States",
          "title": "Wanna see something gorgeous? Apple's new look is coming soon. Learn more at www.apple.com/os/. #LiquidGlass #WWDC25 #Apple #iOS26 #macOS26"
        }
      ]
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "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
}

🟠422Parameter Error

获取流行趋势视频/Get popular trend videos

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request