> ## Documentation Index > Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Suggested Users by Keyword > Get suggested TikTok users for a keyword, region, and count. The response returns account recommendations related to the keyword, making it useful for creator discovery and expanding an account pool.
πŸͺ™ 1 creditper request
## Copy for AI

πŸ€– Why Code When AI Can Do It For You?

Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

## OpenAPI ````yaml en/tiktok.openapi.json GET /v1/tiktok/suggested/users openapi: 3.0.1 info: title: Tiktok API english documentation description: >- The english reference documentation of the Tiktok API includes the interface's purpose, parameter description, response status, and sample structure. version: 1.0.0 servers: - url: https://api.keyapi.ai description: Production security: [] tags: - name: TikTok Influencer - name: TikTok Shop - name: TikTok Content - name: TikTok Intelligence paths: /v1/tiktok/suggested/users: get: tags: - TikTok Influencer summary: Suggested Users by Keyword description: >- Get suggested TikTok users for a keyword, region, and count. The response returns account recommendations related to the keyword, making it useful for creator discovery and expanding an account pool. parameters: - name: keyword in: query description: Creator username or nickname keyword. required: true example: funny schema: type: string example: funny - name: region in: query description: Region or market code, such as US. required: true example: US schema: type: string example: US - name: count in: query description: Number of users to return. required: false example: 10 schema: type: integer example: 10 responses: '200': description: '' content: application/json: schema: type: object properties: {} example: code: 0 message: success data: sug_list: - pos: null content: whofunnymike sug_type: '' word_record: group_id: '4080474512901597768' words_position: 0 words_content: whofunnymike words_source: sug extra_info: sug_sec_user_id: >- MS4wLjABAAAAEX0TfTHfvbvMgbPhEjLx0KNQugfhLSiCuhgR9FDe7MvdHZGTtHkWUCcLr0VLHRAr is_creator_live: '0' is_rich_sug: '1' rich_sug_type: '1' hot_level: '0' rich_sug_avatar_uri: >- https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/a839948c3dca774f56bfd76ca376bb1b~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=3c40ee33&x-expires=1784289600&x-signature=WBCULOd6AtKrsa%2BPgqNw%2FaINKss%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 rich_sug_user_type: '-1' is_history_sug: '0' lang: en is_verified_tako: '0' mention_block_type: 0 is_business_account: false ecom_intent: '0' is_personalized: '0' sug_uniq_id: whofunnymike sug_user_id: '6763279591006389253' recall_reason: orion_qse_uniqid_recall|tiktok_orion_nickname relation_type: '' rich_sug_nickname: FunnyMike qrec_json_info: '{}' generate_time: '0' is_time_sensitive: '0' rich_sug_sec_pos: null highlight_pos: null - pos: null content: funny sug_type: '' word_record: group_id: '4831761300603022055' words_position: 1 words_content: funny words_source: sug extra_info: sug_uniq_id: funny is_creator_live: '0' is_rich_sug: '1' qrec_json_info: '{}' rich_sug_user_type: '-1' is_personalized: '0' is_verified_tako: '0' hot_level: '0' is_time_sensitive: '0' lang: en recall_reason: >- tiktok_index_origin_nickname|tiktok_orion_nickname|tiktok_orion_origin_uniq_id|tiktok_orion_origin_nickname relation_type: '' rich_sug_avatar_uri: >- https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/39b97aea0fb1629f72a4627d566354e5~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=53b99360&x-expires=1784289600&x-signature=u%2BxRy3%2BOJfCIKgXKfonVZ4Cm6S8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 sug_sec_user_id: >- MS4wLjABAAAAT2CqyWfOHJgX9Z1ynRwzX6AUIYOT0g1QBxfzcjbKQy2N88_WSQGm-55fgGs9xQRY sug_user_id: '6956780763094500357' ecom_intent: '2' is_history_sug: '0' generate_time: '0' rich_sug_nickname: funny rich_sug_type: '1' mention_block_type: 0 is_business_account: false rich_sug_sec_pos: null highlight_pos: null - pos: null content: funny_trends1 sug_type: '' word_record: group_id: '2346456687288236331' words_position: 2 words_content: funny_trends1 words_source: sug extra_info: is_creator_live: '0' is_history_sug: '' is_time_sensitive: '0' relation_type: '' generate_time: '0' rich_sug_avatar_uri: >- https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7313838440716435502~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=c3011f51&x-expires=1784289600&x-signature=O9GTLZohVWGD7Oa9yPGUuyyMpXY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 is_verified_tako: '0' is_business_account: false rich_sug_nickname: funny video sug_user_id: '7083422102401958954' is_personalized: '0' recall_reason: >- orion_qse_nickname_recall|tiktok_orion_nickname|tiktok_orion_uniq_id ecom_intent: '0' qrec_json_info: '{}' rich_sug_type: '1' lang: en sug_uniq_id: funny_trends1 mention_block_type: 0 rich_sug_user_type: '-1' sug_sec_user_id: >- MS4wLjABAAAA2zKiA3IdAi0bzEdPP-H2qcCK_qc-R3yJ8tKAZDUzsXU6_G_unDP30B510-7chRjR hot_level: '0' is_rich_sug: '1' rich_sug_sec_pos: null highlight_pos: null - pos: null content: Funny sug_type: '' word_record: group_id: '5107019559866403649' words_position: 3 words_content: Funny words_source: sug extra_info: sug_sec_user_id: >- MS4wLjABAAAAAiG1rQlYi2wF5mo6EL4IcGN86KXNCod55fpV-fCurecouZEvEnqyZ1JavApk2VIE sug_uniq_id: Funny ecom_intent: '2' qrec_json_info: '{}' sug_user_id: '6680439547463599110' is_creator_live: '0' hot_level: '0' is_rich_sug: '1' is_history_sug: '' is_verified_tako: '0' is_business_account: false is_time_sensitive: '0' recall_reason: >- tiktok_index_nickname|tiktok_orion_nickname|tiktok_orion_origin_uniq_id|tiktok_index_origin_nickname|tiktok_orion_origin_nickname generate_time: '0' lang: en rich_sug_avatar_uri: >- https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/7335828606041473045~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=52d3fa45&x-expires=1784289600&x-signature=5L48N6m8jbHs9nBGRvd39Yj6ghc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 rich_sug_nickname: Funny relation_type: '' rich_sug_type: '1' mention_block_type: 0 is_personalized: '0' rich_sug_user_type: '-1' rich_sug_sec_pos: null highlight_pos: null - pos: null content: funnyvideoshumor1 sug_type: '' word_record: group_id: '8403303416831312061' words_position: 4 words_content: funnyvideoshumor1 words_source: sug extra_info: generate_time: '0' lang: en rich_sug_type: '1' is_time_sensitive: '0' qrec_json_info: '{}' rich_sug_nickname: FUNNY videos HUMOR hot_level: '0' is_personalized: '0' rich_sug_user_type: '-1' is_verified_tako: '0' is_creator_live: '0' is_rich_sug: '1' relation_type: '' ecom_intent: '0' rich_sug_avatar_uri: >- https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/1338e2995014bb5acfa23879a1bdc2a9~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=3bfab41d&x-expires=1784289600&x-signature=GD0agnDkOa36%2FnuWTK92u2IXPMY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 is_history_sug: '' mention_block_type: 0 is_business_account: false sug_uniq_id: funnyvideoshumor1 recall_reason: >- orion_qse_uniqid_recall|tiktok_orion_nickname|tiktok_orion_uniq_id sug_sec_user_id: >- MS4wLjABAAAAGQgm5h9BBozzJCepZzVvU-Y-r1jCPGPgjJ6iq5e5di7oKrbHO5n5GyY138M9zKcW sug_user_id: '7157302056696464389' rich_sug_sec_pos: null highlight_pos: null - pos: null content: funny2743 sug_type: '' word_record: group_id: '3632437471889983017' words_position: 5 words_content: funny2743 words_source: sug extra_info: generate_time: '0' rich_sug_type: '1' hot_level: '0' is_creator_live: '0' rich_sug_avatar_uri: >- https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/beb751f09ded4f8a717d7273f147f356~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=b939a01d&x-expires=1784289600&x-signature=jidvEK8v4QhK9NsTtbnUsOrWx0w%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 is_business_account: false ecom_intent: '2' sug_sec_user_id: >- MS4wLjABAAAAsEJFC1dNkHY0Nqkb8OeY8ds7Uon-_js2YSgguEQn5XzS2JbgyHi4syzRC9dLqAEZ rich_sug_nickname: Funny video sug_user_id: '7293557217310934058' is_time_sensitive: '0' relation_type: '' rich_sug_user_type: '-1' is_personalized: '0' lang: en sug_uniq_id: funny2743 is_verified_tako: '0' mention_block_type: 0 is_history_sug: '' qrec_json_info: '{}' recall_reason: >- orion_qse_uniqid_recall|tiktok_orion_nickname|tiktok_orion_uniq_id is_rich_sug: '1' rich_sug_sec_pos: null highlight_pos: null - pos: null content: Funny videos sug_type: '' word_record: group_id: '7946425356140099609' words_position: 6 words_content: Funny videos words_source: sug extra_info: rich_sug_avatar_uri: >- https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/b21c868fe22f07572c9447f03939ae78~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=40b68be1&x-expires=1784289600&x-signature=3zXicAiY1tKJBkm14UBkieD8Yus%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 hot_level: '0' qrec_json_info: '{}' rich_sug_user_type: '-1' is_verified_tako: '0' generate_time: '0' sug_uniq_id: blackeg52 rich_sug_type: '1' is_creator_live: '0' is_time_sensitive: '0' lang: en is_business_account: false sug_sec_user_id: >- MS4wLjABAAAAprNhfBKRDIsSPY9mfdRBfHweZ_B2aOoVvaW24EoXbFl683sW3u3F2Xp9S5F1nH3t ecom_intent: '2' is_personalized: '0' is_rich_sug: '1' sug_user_id: '7214129123428762629' is_history_sug: '' mention_block_type: 0 rich_sug_nickname: Funny videos recall_reason: tiktok_index_nickname relation_type: '' rich_sug_sec_pos: null highlight_pos: null - pos: null content: funny.official sug_type: '' word_record: group_id: '7519729540517189704' words_position: 7 words_content: funny.official words_source: sug extra_info: qrec_json_info: '{}' is_history_sug: '' hot_level: '0' is_creator_live: '0' mention_block_type: 0 recall_reason: orion_qse_nickname_recall sug_uniq_id: funny.official_3 rich_sug_avatar_uri: >- https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/276d107ee4a062d64b9a005e601d30d8~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=9dafd2a7&x-expires=1784289600&x-signature=wz55ab3rDWT3sQNLwb9oouDoGgA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 relation_type: '' rich_sug_nickname: funny.official sug_sec_user_id: >- MS4wLjABAAAAyNrckTO7u02IKvry8xD7-9WraEggNTIpc_fhrNDQjKrMgd7SYkpx3LT4UE4givz2 sug_user_id: '7428264912047129643' ecom_intent: '0' is_personalized: '0' rich_sug_type: '1' is_rich_sug: '1' is_time_sensitive: '0' lang: en generate_time: '0' rich_sug_user_type: '-1' is_verified_tako: '0' is_business_account: false rich_sug_sec_pos: null highlight_pos: null - pos: null content: funny.prank.usa6886 sug_type: '' word_record: group_id: '4273855247689329744' words_position: 8 words_content: funny.prank.usa6886 words_source: sug extra_info: is_history_sug: '' is_rich_sug: '1' rich_sug_type: '1' lang: en is_verified_tako: '0' is_time_sensitive: '0' rich_sug_user_type: '-1' recall_reason: tiktok_orion_nickname|tiktok_orion_uniq_id sug_sec_user_id: >- MS4wLjABAAAAdmCwjfH6nCP51JOfVPKx5d2InKA0gWXu94xHOsQ9EC-RkJPYPl8jPzQEQ1_h6T0Y relation_type: '' generate_time: '0' sug_user_id: '7423360354355446827' qrec_json_info: '{}' mention_block_type: 0 is_business_account: false sug_uniq_id: funny.prank.usa6886 hot_level: '0' rich_sug_nickname: Funny Prank USA πŸ‡ΊπŸ‡Έ ecom_intent: '0' is_creator_live: '0' is_personalized: '0' rich_sug_avatar_uri: >- https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/474e86c4ec0aaf204fdd506bffe76702~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=8f17f7e7&x-expires=1784289600&x-signature=ex%2Bcl8rUwzBGnYyBYbm01HYXSnE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 rich_sug_sec_pos: null highlight_pos: null - pos: null content: Funny animals πŸ˜ΉπŸΆπŸ‡ΊπŸ‡Έ sug_type: '' word_record: group_id: '8573939333381431112' words_position: 9 words_content: Funny animals πŸ˜ΉπŸΆπŸ‡ΊπŸ‡Έ words_source: sug extra_info: is_time_sensitive: '0' generate_time: '0' is_creator_live: '0' rich_sug_type: '1' hot_level: '0' rich_sug_nickname: Funny animals πŸ˜ΉπŸΆπŸ‡ΊπŸ‡Έ lang: en rich_sug_user_type: '-1' is_history_sug: '' is_personalized: '0' recall_reason: tiktok_orion_nickname rich_sug_avatar_uri: >- https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/6d279dddff7290f0277d1fc1e07349f9~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=e877158d&x-expires=1784289600&x-signature=6UA2TkWONYci6Zr4YIgMlAxIT%2Fs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=dafad184&idc=useast8 sug_user_id: '7256770888506262554' sug_sec_user_id: >- MS4wLjABAAAAE1FiEZ4VxRS6YmSl8JyZmrHl2V70AO1HSU39wNfYpOOUdAxH7TVyN7RuXZzqPjUR is_verified_tako: '0' ecom_intent: '2' relation_type: '' is_rich_sug: '1' qrec_json_info: '{}' sug_uniq_id: animalsare_funny mention_block_type: 0 is_business_account: false rich_sug_sec_pos: null highlight_pos: null status_code: 0 status_msg: '' rid: 20260715121355259BC1DCD30B760FED14 extra: now: 1784117635000 logid: 20260715121355259BC1DCD30B760FED14 fatal_item_ids: [] search_request_id: '' api_debug_info: null log_pb: impr_id: 20260715121355259BC1DCD30B760FED14 has_more: 1 requestId: 0259d31f-799c-4b9a-bdac-16367b28e917 headers: {} '400': description: Bad Request content: application/json: schema: type: object example: code: 400 data: null message: Missing required parameter '401': description: Unauthorized content: application/json: schema: type: object example: code: 401 data: null message: apiKey is null '402': description: Payment Required content: application/json: schema: type: object example: code: 402 data: null message: apiKey quota is not enough '429': description: Too Many Requests content: application/json: schema: type: object example: code: 429 data: null message: qps limit exceeded '500': description: Internal Server Error content: application/json: schema: type: object example: code: 500 data: null message: Internal server error deprecated: false security: - JWT Bearer: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url 'https://api.keyapi.ai/v1/tiktok/suggested/users?keyword=funny®ion=US&count=10' \ --header 'Authorization: Bearer ' - lang: python label: Python source: |- import requests response = requests.get( 'https://api.keyapi.ai/v1/tiktok/suggested/users', params={"keyword": "funny", "region": "US", "count": 10}, headers={'Authorization': 'Bearer '} ) print(response.json()) - lang: javascript label: JavaScript source: >- const params = new URLSearchParams({"keyword": "funny", "region": "US", "count": 10}); const response = await fetch(`https://api.keyapi.ai/v1/tiktok/suggested/users?${params}`, { method: 'GET', headers: { 'Authorization': 'Bearer ' } }); const data = await response.json(); console.log(data); components: securitySchemes: JWT Bearer: type: http scheme: bearer bearerFormat: JWT description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard). ````