[中文]

用途:

• 搜索TikTok广告创意库中的广告，支持多维度筛选和排序
• 发现特定行业、关键词或目标相关的高效广告案例
• 为广告策划和创意制作提供参考和灵感

参数:

• keyword: 搜索关键词，可选参数，留空返回所有广告
• objective: 广告目标，可选；留空表示不按目标筛选
• like: 表现分位，可选；留空表示不按表现分位筛选
• period: 时间范围（天），如7、30、120、180天
• industry: 行业ID列表，多个ID用逗号分隔。完整行业ID列表见: https://github.com/TikHub/TikTok-Ads-Industry-Code
• page: 页码，默认1
• limit: 每页数量，默认20，最大50
• order_by: 排序方式，"for_you"=为你推荐，"likes"=按点赞数排序
• country_code: 国家代码，如US、UK、JP等
• ad_format: 广告格式，可选；1=Spark Ads，2=非 Spark Ads
• ad_language: 广告语言代码，可选，如en、zh-Hant等
• duration: 视频时长筛选值，可选
• pattern_label: 创意趋势标签，可选
• cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据

注意:

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

常用行业ID示例:

• 游戏: 27000000000
• 电子商务: 19000000000
• 金融服务: 30000000000
• 教育: 10000000000
• 美妆个护: 22000000000
• 食品饮料: 16000000000

返回内容说明:

• materials: 广告素材列表
  • id: 广告素材ID
  • aweme_id: 广告视频ID
  • desc: 广告描述
  • create_time: 创建时间
  • video_info: 视频信息
    • cover: 封面图URL
    • duration: 时长（秒）
  • statistics: 统计数据
    • digg_count: 点赞数
    • comment_count: 评论数
    • share_count: 分享数
  • ads_info: 广告信息
    • advertiser_name: 广告主名称
    • landing_page: 落地页URL
• pagination: 分页信息
  • page: 当前页
  • limit: 每页数量
  • total: 总数量
  • has_more: 是否有更多

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/search_ads",
  "params": {
    "keyword": "cat toy",
    "period": 180,
    "industry": "27000000000",
    "page": 1,
    "limit": 20
  },
  "data": {
    "materials": [
      {
        "id": "7213258221116751874",
        "aweme_id": "7213258221116751874",
        "desc": "Best interactive cat toys! Keep your cats entertained 🐱",
        "create_time": 1680234567,
        "video_info": {
          "cover": "https://p16-ad-sg.tiktokcdn.com/img/xxx.jpeg",
          "duration": 15
        },
        "statistics": {
          "digg_count": 128456,
          "comment_count": 3421,
          "share_count": 892
        },
        "ads_info": {
          "advertiser_name": "PetToys Inc.",
          "landing_page": "https://example.com/cat-toys"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1523,
      "has_more": true
    }
  }
}

[English]

Purpose:

• Search ads in TikTok's Creative Center with multi-dimensional filtering and sorting
• Discover effective ad cases related to specific industries, keywords, or objectives
• Provide reference and inspiration for ad planning and creative production

Parameters:

• keyword: Search keyword, optional, returns all ads if empty
• objective: Optional ad objective; omit it to include all objectives
• like: Optional performance percentile; omit it to include all percentiles
• period: Time period in days, e.g., 7, 30, 120, 180 days
• industry: Industry ID list, multiple IDs separated by commas. Full industry ID list: https://github.com/TikHub/TikTok-Ads-Industry-Code
• page: Page number, default 1
• limit: Items per page, default 20, max 50
• order_by: Sort method, "for_you"=Recommended, "likes"=Sort by likes
• country_code: Country code, e.g., US, UK, JP
• ad_format: Optional ad format; 1=Spark Ads, 2=Non-Spark Ads
• ad_language: Optional ad language code, e.g., en, zh-Hant
• duration: Optional video duration filter value
• pattern_label: Optional creative pattern label
• 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.

Common Industry ID Examples:

• Games: 27000000000
• E-commerce: 19000000000
• Financial Services: 30000000000
• Education: 10000000000
• Beauty & Personal Care: 22000000000
• Food & Beverage: 16000000000

Return Description:

• materials: List of ad materials
  • id: Ad material ID
  • aweme_id: Ad video ID
  • desc: Ad description
  • create_time: Creation time
  • video_info: Video information
    • cover: Cover image URL
    • duration: Duration in seconds
  • statistics: Statistics
    • digg_count: Number of likes
    • comment_count: Number of comments
    • share_count: Number of shares
  • ads_info: Ad information
    • advertiser_name: Advertiser name
    • landing_page: Landing page URL
• pagination: Pagination info
  • page: Current page
  • limit: Items per page
  • total: Total count
  • has_more: Whether there are more items

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/search_ads",
  "params": {
    "keyword": "cat toy",
    "period": 180,
    "industry": "27000000000",
    "page": 1,
    "limit": 20
  },
  "data": {
    "materials": [
      {
        "id": "7213258221116751874",
        "aweme_id": "7213258221116751874",
        "desc": "Best interactive cat toys! Keep your cats entertained 🐱",
        "create_time": 1680234567,
        "video_info": {
          "cover": "https://p16-ad-sg.tiktokcdn.com/img/xxx.jpeg",
          "duration": 15
        },
        "statistics": {
          "digg_count": 128456,
          "comment_count": 3421,
          "share_count": 892
        },
        "ads_info": {
          "advertiser_name": "PetToys Inc.",
          "landing_page": "https://example.com/cat-toys"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1523,
      "has_more": true
    }
  }
}