Search APIs
Loading…
← API Store
Social

TikTok

TikTok

TikTok search suggestions

GET /tiktok/v1/search/suggestions
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qrequiredstring Example: cook

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "credits_used": 1,
  "items": [
    {
      "content": "cooking video",
      "extra_info": {
        "cut_query": "[\"cooking\",\"video\"]",
        "ecom_intent": "2",
        "generate_time": "1746017486",
        "hot_level": "0",
        "is_history_sug": "0",
        "is_personalized": "0",
        "is_time_sensitive": "0",
        "lang": "en",
        "penetrate_info": "{\"words_type_to_voucher_ids\":\"\",\"lvl1_category_id\":\"\",\"ecom_intent\":\"2\",\"is_time_sensitive\":\"0\",\"generate_time\":\"1746017486\",\"ecom_trigger_i…",
        "predict_ctr_score": 0.50735897,
        "qrec_json_info": "{}",
        "recall_reason": "tiktok_index_experience_decision_query",
        "textnet_id": "1012##363",
        "words_type": ""
      },
      "highlight_pos": [
        {
          "begin": 4,
          "end": 12
        }
      ],
      "pos": [
        {
          "begin": 0,
          "end": 3
        }
      ],
      "rich_sug_sec_pos": null,
      "sug_type": "",
      "word_record": {
        "group_id": "8785455721195408705",
        "qrec_json_info": "{}",
        "textnet_id": "1012##363",
        "words_content": "cooking video",
        "words_label": "",
        "words_lang": "en",
        "words_position": 0,
        "words_source": "sug"
      }
    },
    {
      "content": "Cooking Food Videos",
      "extra_info": {
        "cut_query": "[\"Cooking\",\"Food\",\"Videos\"]",
        "ecom_intent": "1",
        "generate_time": "1748413764",
        "hot_level": "0",
        "is_history_sug": "0",
        "is_personalized": "0",
        "is_time_sensitive": "0",
        "lang": "en",
        "penetrate_info": "{\"generate_time\":\"1748413764\",\"poi_card_id_list\":\"\",\"recall_reason\":\"tiktok_experience_orion_query\",\"is_ramandan_promotion\":\"\",\"hot_level\":\"…",
        "predict_ctr_score": 0.48593155,
        "qrec_json_info": "{}",
        "recall_reason": "tiktok_experience_orion_query",
        "textnet_id": "1012##363",
        "words_type": ""
      },
      "highlight_pos": [
        {
          "begin": 4,
          "end": 18
        }
      ],
      "pos": [
        {
          "begin": 0,
          "end": 3
        }
      ],
      "rich_sug_sec_pos": null,
      "sug_type": "",
      "word_record": {
        "group_id": "646531144000016171",
        "qrec_json_info": "{}",
        "textnet_id": "1012##363",
        "words_content": "Cooking Food Videos",
        "words_label": "",
        "words_lang": "en",
        "words_position": 1,
        "words_source": "sug"
      }
    },
    "… 8 more"
  ],
  "query": "cook",
  "suggestions": [
    "cooking video",
    "Cooking Food Videos",
    "… 8 more"
  ]
}
Response fields (43)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.credits_usedinteger
$.itemsarray
$.items[]object | string
$.items[].contentstring
$.items[].extra_infoobject
$.items[].extra_info.cut_querystring
$.items[].extra_info.ecom_intentstring
$.items[].extra_info.generate_timestring
$.items[].extra_info.hot_levelstring
$.items[].extra_info.is_history_sugstring
$.items[].extra_info.is_personalizedstring
$.items[].extra_info.is_time_sensitivestring
$.items[].extra_info.langstring
$.items[].extra_info.penetrate_infostring
$.items[].extra_info.predict_ctr_scorenumber
$.items[].extra_info.qrec_json_infostring
$.items[].extra_info.recall_reasonstring
$.items[].extra_info.textnet_idstring
$.items[].extra_info.words_typestring
$.items[].highlight_posarray
$.items[].highlight_pos[]object
$.items[].highlight_pos[].begininteger
$.items[].highlight_pos[].endinteger
$.items[].posarray
$.items[].pos[]object
$.items[].pos[].begininteger
$.items[].pos[].endinteger
$.items[].rich_sug_sec_posnull
$.items[].sug_typestring
$.items[].word_recordobject
$.items[].word_record.group_idstring
$.items[].word_record.qrec_json_infostring
$.items[].word_record.textnet_idstring
$.items[].word_record.words_contentstring
$.items[].word_record.words_labelstring
$.items[].word_record.words_langstring
$.items[].word_record.words_positioninteger
$.items[].word_record.words_sourcestring
$.querystring
$.suggestionsarray
$.suggestions[]string