--- title: "获取推荐广告/Get recommended ads" method: POST path: "/api/v1/tiktok/ads/get_recommended_ads" tags: ["TikTok-Ads-API"] --- # 获取推荐广告/Get recommended ads `POST /api/v1/tiktok/ads/get_recommended_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/get_recommended_ads` - Auth: HTTP bearer # [中文] ### 用途: - 基于指定广告获取相似的推荐广告列表 - 发现同行业或相似风格的优秀广告案例 - 为广告创意提供更多参考和灵感 ### 参数: - material_id: 参考广告素材ID，必填参数 - industry: 行业ID，如游戏行业：25308000000 - country_code: 国家代码，如US、UK、JP等 - cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据 ### 注意: - 如果您应用了一个或多个筛选条件后没有返回任何结果，请尝试调整或移除部分筛选条件。TikTok 创作者数据集仅收录部分热门数据，不一定包含全量数据。 ### 返回内容说明: - `materials`: 推荐广告素材列表 - `ad_title`: 广告标题 - `brand_name`: 品牌名称 - `cost`: 花费等级 - `ctr`: 点击率 - `favorite`: 是否收藏 - `id`: 广告ID - `industry_key`: 行业键值 - `is_search`: 是否搜索结果 - `like`: 点赞数 - `objective_key`: 广告目标键值 - `tag`: 标签 - `video_info`: 视频信息 - `vid`: 视频ID - `duration`: 时长（秒） - `cover`: 封面图URL - `video_url`: 视频播放地址 - `360p`: 360p画质 - `480p`: 480p画质 - `540p`: 540p画质 - `720p`: 720p画质 - `width`: 视频宽度 - `height`: 视频高度 ### 示例响应: ```json { "code": 200, "router": "/api/v1/tiktok/ads/get_recommended_ads", "params": { "material_id": "7213258221116751874", "industry": "25308000000", "country_code": "US" }, "data": { "code": 0, "msg": "OK", "data": { "materials": [ { "ad_title": "What will you decide?", "brand_name": "Eatventure", "cost": 2, "ctr": 0.07, "favorite": false, "id": "7164756134804979714", "industry_key": "label_25308000000", "is_search": false, "like": 1009024, "objective_key": "campaign_objective_conversion", "tag": 3, "video_info": { "vid": "v10033g50000ctgjtl7og65ivnpdo87g", "duration": 30.016, "cover": "https://p16-sign-sg.tiktokcdn.com/v0201/ogKcNlWrjIQwDVBDpBbeR7PDQXnAIeA9Dgbb4w~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 } } ] } } } ``` # [English] ### Purpose: - Get similar recommended ads based on a specified ad - Discover excellent ad cases in the same industry or with similar styles - Provide more references and inspiration for ad creativity ### Parameters: - material_id: Reference ad material ID, required parameter - industry: Industry ID, e.g., Games: 25308000000 - country_code: Country code, e.g., US, UK, JP - 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`: Recommended ad materials list - `ad_title`: Ad title - `brand_name`: Brand name - `cost`: Cost level - `ctr`: Click-through rate - `favorite`: Whether favorited - `id`: Ad ID - `industry_key`: Industry key - `is_search`: Whether search result - `like`: Like count - `objective_key`: Ad objective key - `tag`: Tag - `video_info`: Video information - `vid`: Video ID - `duration`: Duration in seconds - `cover`: Cover image URL - `video_url`: Video playback URLs - `360p`: 360p quality - `480p`: 480p quality - `540p`: 540p quality - `720p`: 720p quality - `width`: Video width - `height`: Video height ### Example Response: ```json { "code": 200, "router": "/api/v1/tiktok/ads/get_recommended_ads", "params": { "material_id": "7213258221116751874", "industry": "25308000000", "country_code": "US" }, "data": { "code": 0, "msg": "OK", "data": { "materials": [ { "ad_title": "What will you decide?", "brand_name": "Eatventure", "cost": 2, "ctr": 0.07, "favorite": false, "id": "7164756134804979714", "industry_key": "label_25308000000", "is_search": false, "like": 1009024, "objective_key": "campaign_objective_conversion", "tag": 3, "video_info": { "vid": "v10033g50000ctgjtl7og65ivnpdo87g", "duration": 30.016, "cover": "https://p16-sign-sg.tiktokcdn.com/v0201/ogKcNlWrjIQwDVBDpBbeR7PDQXnAIeA9Dgbb4w~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 } } ] } } } ``` ## Request body - BodyGetRecommendedAdsApiV1TiktokAdsGetRecommendedAdsPost - `material_id` string, required: 广告素材ID/Ad material ID - `industry` string: 行业ID/Industry ID - `country_code` string: 国家代码/Country code - `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_recommended_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)