[中文]

用途:

搜索TikTok广告创意库中的广告，支持多维度筛选和排序

发现特定行业、关键词或目标相关的高效广告案例

为广告策划和创意制作提供参考和灵感

参数:

keyword: 搜索关键词，可选参数，留空返回所有广告

objective: 广告目标，1=全部

like: 点赞数筛选，1=全部

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

industry: 行业ID列表，多个ID用逗号分隔。完整行业ID列表见: https://github.com/Tikomni/TikTok-Ads-Industry-Code

page: 页码，默认1

limit: 每页数量，默认20，最大50

order_by: 排序方式，"for_you"=为你推荐，"likes"=按点赞数排序

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

ad_format: 广告格式，1=视频广告

ad_language: 广告语言代码，如en、zh等

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/u1/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: Ad objective, 1=All

like: Like count filter, 1=All

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/Tikomni/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: Ad format, 1=Video ads

ad_language: Ad language code, e.g., en, zh

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/u1/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
    }
  }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Example

{
    "objective": 1,
    "like": 1,
    "period": 180,
    "page": 1,
    "limit": 20,
    "order_by": "for_you",
    "country_code": "US",
    "ad_format": 1,
    "ad_language": "en"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

搜索广告/Search ads

[中文]

用途:

参数:

注意:

常用行业ID示例:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Note:

Common Industry ID Examples:

Return Description:

Example Response:

Request

Request Code Samples

Responses

搜索广告/Search ads

[中文]#

用途:#

参数:#

注意:#

常用行业ID示例:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Note:#

Common Industry ID Examples:#

Return Description:#

Example Response:#

Request

Request Code Samples

Responses

[中文]

用途:

参数:

注意:

常用行业ID示例:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Note:

Common Industry ID Examples:

Return Description:

Example Response: