--- title: "获取热门广告聚光灯/Get top ads spotlight" method: POST path: "/api/v1/tiktok/ads/get_top_ads_spotlight" tags: ["TikTok-Ads-API"] --- # 获取热门广告聚光灯/Get top ads spotlight `POST /api/v1/tiktok/ads/get_top_ads_spotlight` ## 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/get_top_ads_spotlight` - Auth: HTTP bearer # [中文] ### 用途: - 获取特定行业的热门广告聚光灯，展示行业内最受关注的广告案例 - 分析行业内的广告创意趋势和优秀案例 - 为广告创意制作提供灵感和参考 ### 参数: - 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`: 是否有更多 ### 示例响应: ```json { "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: ```json { "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 } } } ``` ## Request body - BodyGetTopAdsSpotlightApiV1TiktokAdsGetTopAdsSpotlightPost - `industry` string: 行业ID(可选，不传返回跨行业聚合)/Industry ID (optional) - `page` integer: 页码/Page number - `limit` integer: 每页数量/Items per page - `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/get_top_ads_spotlight/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)