[中文]

用途:

基于指定广告获取相似的推荐广告列表

发现同行业或相似风格的优秀广告案例

为广告创意提供更多参考和灵感

参数:

material_id: 参考广告素材ID，必填参数

industry: 行业ID，如游戏行业：25308000000

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

注意:

如果您应用了一个或多个筛选条件后没有返回任何结果，请尝试调整或移除部分筛选条件。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: 视频高度

示例响应:

{
  "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

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:

{
  "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
          }
        }
      ]
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

获取推荐广告/Get recommended ads

[中文]

用途:

参数:

注意:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Note:

Return Description:

Example Response:

Request

Responses

获取推荐广告/Get recommended ads

[中文]#

用途:#

参数:#

注意:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Note:#

Return Description:#

Example Response:#

Request

Responses

[中文]

用途:

参数:

注意:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Note:

Return Description:

Example Response: