← API Store
Social
TikTok
TikTok
TikTok search suggestions
GET /tiktok/v1/search/suggestionsEvery 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
| Name | Type | Description |
|---|---|---|
qrequired | string | 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 |
$.cached | boolean |
$.credits_used | integer |
$.items | array |
$.items[] | object | string |
$.items[].content | string |
$.items[].extra_info | object |
$.items[].extra_info.cut_query | string |
$.items[].extra_info.ecom_intent | string |
$.items[].extra_info.generate_time | string |
$.items[].extra_info.hot_level | string |
$.items[].extra_info.is_history_sug | string |
$.items[].extra_info.is_personalized | string |
$.items[].extra_info.is_time_sensitive | string |
$.items[].extra_info.lang | string |
$.items[].extra_info.penetrate_info | string |
$.items[].extra_info.predict_ctr_score | number |
$.items[].extra_info.qrec_json_info | string |
$.items[].extra_info.recall_reason | string |
$.items[].extra_info.textnet_id | string |
$.items[].extra_info.words_type | string |
$.items[].highlight_pos | array |
$.items[].highlight_pos[] | object |
$.items[].highlight_pos[].begin | integer |
$.items[].highlight_pos[].end | integer |
$.items[].pos | array |
$.items[].pos[] | object |
$.items[].pos[].begin | integer |
$.items[].pos[].end | integer |
$.items[].rich_sug_sec_pos | null |
$.items[].sug_type | string |
$.items[].word_record | object |
$.items[].word_record.group_id | string |
$.items[].word_record.qrec_json_info | string |
$.items[].word_record.textnet_id | string |
$.items[].word_record.words_content | string |
$.items[].word_record.words_label | string |
$.items[].word_record.words_lang | string |
$.items[].word_record.words_position | integer |
$.items[].word_record.words_source | string |
$.query | string |
$.suggestions | array |
$.suggestions[] | string |