TikTok modelsapi generation api

tiktok/ads/query-suggestions

Get popular query suggestions for ad search Understand current popular ad search keywords and trends Help discover new creative directions and hot topics

Input
Idle

Example output — click Run to generate your own

API README

Get query suggestions

Purpose:

  • Get popular query suggestions for ad search
  • Understand current popular ad search keywords and trends
  • Help discover new creative directions and hot topics

Parameters:

  • query: Input keyword (optional), returns suggestions based on input; popular ones if omitted
  • count: Number of suggestions to return, default 50
  • scenario: Scenario type, default 1
  • country_code: Country code, default US

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:

  • query: Query suggestions list (string array)

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_query_suggestions",
  "params": {
    "count": "50",
    "scenario": "1"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "query": [
        "shop now",
        "50% off"
      ]
    }
  }
}

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

Related Models

tiktok/ads/ad-interactive-analysisGet ad interactive time analysis to understand audience retention and engagement at different video time points Analyze ad video attractiveness curve to find optimal duration and key interaction points Optimize ad content structure to improve overall effectivenesstiktok/ads/ad-keyframe-analysisGet keyframe analysis of ad videos to understand audience retention at different time points Analyze which time points attract viewers most and where viewers drop off Help optimize ad video structure to improve completion ratestiktok/ads/ad-percentileGet ad percentile ranking data within the industry Understand ad performance levels relative to peers across various metrics Help evaluate ad effectiveness and develop optimization strategiestiktok/ads/ads-detailRetrieve detailed information about a single TikTok ad, including creative content, creator info, and engagement data Analyze ad performance metrics such as views, likes, comments, and other core statistics Help advertisers and marketers gain deep insights into specific ad effectiveness and user feedbacktiktok/ads/configure-safetyGet the safety/availability config switches of TikTok Creative Center search modules Check whether top ads, keyword, hashtag, sound, creator searches are currently availabletiktok/ads/location-listGet the list of countries/regions supported by TikTok Creative Center Useful as a reference for the country_code parameter of other endpointstiktok/ads/recommended-adsGet 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 creativitytiktok/ads/search-adsSearch 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