[中文]

用途:

• 获取特定行业的热门广告聚光灯，展示行业内最受关注的广告案例
• 分析行业内的广告创意趋势和优秀案例
• 为广告创意制作提供灵感和参考

参数:

• industry: 行业ID，可选参数，不传则返回跨行业聚合榜单，如教育行业：25000000000
• page: 页码，默认1
• limit: 每页数量，默认20
• cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据

注意:

• 如果您应用了一个或多个筛选条件后没有返回任何结果，请尝试调整或移除部分筛选条件。TikTok 创作者数据集仅收录部分热门数据，不一定包含全量数据。

返回内容说明:

• materials: 广告素材列表
  • cost: 花费等级
  • ctr: 点击率
  • highlight: 亮点描述
  • id: 广告ID
  • like: 点赞数
  • video_info: 视频信息
    • vid: 视频ID
    • duration: 时长（秒）
    • cover: 封面图片URL
    • video_url: 多种画质的视频播放URL
      • 360p: 360p画质视频URL
      • 480p: 480p画质视频URL
      • 540p: 540p画质视频URL
      • 720p: 720p画质视频URL
    • width: 视频宽度
    • height: 视频高度
• pagination: 分页信息
  • page: 当前页
  • size: 每页数量
  • total: 总数量
  • has_more: 是否有更多

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_top_ads_spotlight",
  "params": {
    "industry": "25000000000",
    "page": "1",
    "limit": "20"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "materials": [
        {
          "cost": 2,
          "ctr": 0.14,
          "highlight": "Through the lens of a real person talking his way through the game, the video appears credible with commentary that sounds trustworthy.",
          "id": "7165768841499066370",
          "like": 377333,
          "video_info": {
            "vid": "v0911dg40001cdo7ukjc77ua0r66rqqg",
            "duration": 19.156,
            "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-v-2c3654-us/1c87385bed544878bb94b61816a653a1~tplv-noop.image",
            "video_url": {
              "360p": "https://v16m-default.tiktokcdn.com/9e086e91176219d756e9c875fb739dc4/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oIQcoRBNNpXbALnjIeLgbKfwWPDDDDIgQ9l6BF",
              "480p": "https://v16m-default.tiktokcdn.com/2f304931bd351dad0e43e9771364bd78/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/o8lIsnPILWelBwDbDgDuwQj9UlNebAYdDUXBKS",
              "540p": "https://v16m-default.tiktokcdn.com/351ae3acb3121d42db8a5091811b2340/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oQwpeXyWjDBg7KXcBDeDgPnDDbANoISoQIb9Ql",
              "720p": "https://v16m-default.tiktokcdn.com/a04bacceb906e5336a68158479f5eac5/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oQQnWCmCDfpgIxegjrKAXZlbIPDNBDDbZQBHw9"
            },
            "width": 720,
            "height": 1280
          }
        }
      ],
      "pagination": {
        "page": 1,
        "size": 20,
        "total": 100,
        "has_more": true
      }
    }
  }
}

[English]

Purpose:

• Get top ads spotlight for specific industries, showcasing the most popular ad cases
• Analyze creative trends and excellent cases within the industry
• Provide inspiration and reference for ad creative production

Parameters:

• industry: Industry ID, optional, returns cross-industry list if omitted, e.g., Education: 25000000000
• page: Page number, default 1
• limit: Items per page, default 20
• cookie: Custom Cookie string, optional parameter, can be used to fetch more data

Note:

• If you've applied one or more filters and there's no result returned, try adjusting or removing some of them. The TikTok Creator dataset only includes a selection of popular records and may not contain the complete set of data.

Return Description:

• materials: Ad materials list
  • cost: Cost level
  • ctr: Click-through rate
  • highlight: Highlight description
  • id: Ad ID
  • like: Like count
  • video_info: Video information
    • vid: Video ID
    • duration: Duration in seconds
    • cover: Cover image URL
    • video_url: Video playback URLs in multiple qualities
      • 360p: 360p quality video URL
      • 480p: 480p quality video URL
      • 540p: 540p quality video URL
      • 720p: 720p quality video URL
    • width: Video width
    • height: Video height
• 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_top_ads_spotlight",
  "params": {
    "industry": "25000000000",
    "page": "1",
    "limit": "20"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "materials": [
        {
          "cost": 2,
          "ctr": 0.14,
          "highlight": "Through the lens of a real person talking his way through the game, the video appears credible with commentary that sounds trustworthy.",
          "id": "7165768841499066370",
          "like": 377333,
          "video_info": {
            "vid": "v0911dg40001cdo7ukjc77ua0r66rqqg",
            "duration": 19.156,
            "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-v-2c3654-us/1c87385bed544878bb94b61816a653a1~tplv-noop.image",
            "video_url": {
              "360p": "https://v16m-default.tiktokcdn.com/9e086e91176219d756e9c875fb739dc4/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oIQcoRBNNpXbALnjIeLgbKfwWPDDDDIgQ9l6BF",
              "480p": "https://v16m-default.tiktokcdn.com/2f304931bd351dad0e43e9771364bd78/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/o8lIsnPILWelBwDbDgDuwQj9UlNebAYdDUXBKS",
              "540p": "https://v16m-default.tiktokcdn.com/351ae3acb3121d42db8a5091811b2340/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oQwpeXyWjDBg7KXcBDeDgPnDDbANoISoQIb9Ql",
              "720p": "https://v16m-default.tiktokcdn.com/a04bacceb906e5336a68158479f5eac5/684d7e29/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oQQnWCmCDfpgIxegjrKAXZlbIPDNBDDbZQBHw9"
            },
            "width": 720,
            "height": 1280
          }
        }
      ],
      "pagination": {
        "page": 1,
        "size": 20,
        "total": 100,
      "has_more": true
    }
  }
}