--- title: "搜索广告/Search ads" method: POST path: "/api/v1/tiktok/ads/search_ads" tags: ["TikTok-Ads-API"] --- # 搜索广告/Search ads `POST /api/v1/tiktok/ads/search_ads` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/tiktok/ads/search_ads` - Auth: HTTP bearer # [中文] ### 用途: - 搜索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`: 是否有更多 ### 示例响应: ```json { "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: ```json { "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 } } } ``` ## Request body - BodySearchAdsApiV1TiktokAdsSearchAdsPost - `objective` integer, nullable: 广告目标类型（可选）/Ad objective (optional; 1:流量 2:应用安装 3:转化 4:视频浏览 5:触达 6:潜在客户 7:产品销售) - `like` integer, nullable: 表现排名（可选）/Performance rank (optional; 1:前1-20% 2:前21-40% 3:前41-60% 4:前61-80% 5:前81-100%) - `period` integer: 时间段/Time period (days) - `industry` string: 行业ID/Industry ID - `keyword` string: 搜索关键词/Search keyword - `page` integer: 页码/Page number - `limit` integer: 每页数量/Items per page - `order_by` string: 排序方式/Sort by (for_you, likes) - `country_code` string: 国家代码/Country code - `ad_format` integer, nullable: 广告格式（可选）/Ad format (optional; 1:Spark Ads 2:Non-Spark Ads) - `ad_language` string, nullable: 广告语言（可选）/Ad language (optional) - `duration` integer, nullable: 视频时长筛选值（可选）/Video duration filter value (optional) - `pattern_label` string, nullable: 创意趋势标签（可选）/Creative pattern label (optional) - `search_id` string: 搜索ID（可选）/Search ID (optional) - `cookie` string: 自定义Cookie字符串（可选） ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/tiktok/ads/search_ads/post.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)