tiktok/ads/recommended-ads

Get recommended ads

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

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.