tiktok/ads/search-ads

Search ads

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: Ad objective, 1=All
• like: Like count filter, 1=All
• 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: Ad format, 1=Video ads
• ad_language: Ad language code, e.g., en, zh

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:

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

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