> ## 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.

# 关键词获取建议用户

> 这是按关键词获取建议用户的接口，当前通过 `keyword`、`region`、`count` 找平台建议的相关账号，偏账号推荐而不是严格搜索排名。结果是平台根据关键词推荐的一组账号样本，返回风格偏“建议关注对象”，很适合快速摸出某类内容常见的账号池。

**接口用途推荐**
- 适合做达人发现
- 关键词相关账号池扩充
- 找某种内容风格的账号样本、给商务团队做达人初筛

**注意事项**
- 实时接口可能遇到风控，如果接口返回code=500，请继续重试（code=500不消耗当前调用额度）

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">1 credit</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">每次请求</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 让 AI 帮你写调用代码</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。</p>
  </div>

  <div className="mt-4">
    <button type="button" className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50" onClick={() => navigator.clipboard.writeText("我想调用 KeyAPI 接口：GET https://api.keyapi.ai/v1/tiktok/suggested/users\n\n请帮我编写调用代码，并包含必要的错误处理、参数校验和响应处理逻辑。\n\n接口信息：\n\nEndpoint: GET https://api.keyapi.ai/v1/tiktok/suggested/users\n\nDescription: **接口整体描述**\n这是按关键词获取建议用户的接口，当前通过 `keyword`、`region`、`count` 找平台建议的相关账号，偏账号推荐而不是严格搜索排名。结果是平台根据关键词推荐的一组账号样本，返回风格偏“建议关注对象”，很适合快速摸出某类内容常见的账号池。\n\n**接口用途推荐**\n- 适合做达人发现\n- 关键词相关账号池扩充\n- 找某种内容风格的账号样本、给商务团队做达人初筛\n\n**注意事项**\n- 实时接口可能遇到风控，如果接口返回code=500，请继续重试（code=500不消耗当前调用额度）\n\nRequired Headers:\n--header 'Authorization: Bearer <YOUR_API_KEY>'\n\nParameters:\n- keyword (Required): 达人username或nickname. Example: funny\n- region (Required): . Example: US\n- count (Optional): . Example: 10\n\nExample Response:\n{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": {\n    \"sug_list\": [\n      {\n        \"pos\": null,\n        \"content\": \"whofunnymike\",\n        \"sug_type\": \"\",\n        \"word_record\": {\n          \"group_id\": \"4080474512901597768\",\n          \"words_position\": 0,\n          \"words_content\": \"whofunnymike\",\n          \"words_source\": \"sug\"\n        },\n        \"extra_info\": {\n          \"sug_sec_user_id\": \"MS4wLjABAAAAEX0TfTHfvbvMgbPhEjLx0KNQugfhLSiCuhgR9FDe7MvdHZGTtHkWUCcLr0VLHRAr\",\n          \"is_creator_live\": \"0\",\n          \"is_rich_sug\": \"1\",\n          \"rich_sug_type\": \"1\",\n          \"hot_level\": \"0\",\n          \"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\",\n          \"rich_sug_user_type\": \"-1\",\n          \"is_history_sug\": \"0\",\n          \"lang\": \"en\",\n          \"is_verified_tako\": \"0\",\n          \"mention_block_type\": 0,\n          \"is_business_account\": false,\n          \"ecom_intent\": \"0\",\n          \"is_personalized\": \"0\",\n          \"sug_uniq_id\": \"whofunnymike\",\n          \"sug_user_id\": \"6763279591006389253\",\n          \"recall_reason\": \"orion_qse_uniqid_recall|tiktok_orion_nickname\",\n          \"relation_type\": \"\",\n          \"rich_sug_nickname\": \"FunnyMike\",\n          \"qrec_json_info\": \"{}\",\n          \"generate_time\": \"0\",\n          \"is_time_sensitive\": \"0\"\n        },\n        \"rich_sug_sec_pos\": null,\n        \"highlight_pos\": null\n      },\n      {\n        \"pos\": null,\n        \"content\": \"funny\",\n        \"sug_type\": \"\",\n        \"word_record\": {\n          \"group_id\": \"4831761300603022055\",\n          \"words_position\": 1,\n          \"words_content\": \"funny\",\n          \"words_source\": \"sug\"\n        },\n        \"extra_info\": {\n          \"sug_uniq_id\": \"funny\",\n          \"is_creator_live\": \"0\",\n          \"is_rich_sug\": \"1\",\n          \"qrec_json_info\": \"{}\",\n          \"rich_sug_user_type\": \"-1\",\n          \"is_personalized\": \"0\",\n          \"is_verified_tako\": \"0\",\n          \"hot_level\": \"0\",\n          \"is_time_sensitive\": \"0\",\n          \"lang\": \"en\",\n          \"recall_reason\": \"tiktok_index_origin_nickname|tiktok_orion_nickname|tiktok_orion_origin_uniq_id|tiktok_orion_origin_nickname\",\n          \"relation_type\": \"\",\n          \"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=53b99\n  ... truncated ...\n\n请根据以上信息给出可直接运行的示例代码。")}>
      ✨ 复制给 AI
    </button>
  </div>
</div>


## OpenAPI

````yaml zh/tiktok.zh.openapi.json GET /v1/tiktok/suggested/users
openapi: 3.0.1
info:
  title: Tiktok API 中文文档
  description: Tiktok API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security: []
tags:
  - name: TikTok 达人
  - name: TikTok 店铺
  - name: TikTok 内容数据
  - name: TikTok 趋势洞察
paths:
  /v1/tiktok/suggested/users:
    get:
      tags:
        - TikTok 达人
      summary: 关键词获取建议用户
      description: >-
        这是按关键词获取建议用户的接口，当前通过 `keyword`、`region`、`count`
        找平台建议的相关账号，偏账号推荐而不是严格搜索排名。结果是平台根据关键词推荐的一组账号样本，返回风格偏“建议关注对象”，很适合快速摸出某类内容常见的账号池。


        **接口用途推荐**

        - 适合做达人发现

        - 关键词相关账号池扩充

        - 找某种内容风格的账号样本、给商务团队做达人初筛


        **注意事项**

        - 实时接口可能遇到风控，如果接口返回code=500，请继续重试（code=500不消耗当前调用额度）
      parameters:
        - name: keyword
          in: query
          description: 达人username或nickname
          required: true
          example: funny
          schema:
            type: string
            example: funny
        - name: region
          in: query
          description: ''
          required: true
          example: US
          schema:
            type: string
            example: US
        - name: count
          in: query
          description: ''
          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: 请求参数错误，请检查必填字段和参数格式
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: Missing required parameter
        '401':
          description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: 账户余额或额度不足
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: 请求过于频繁，已触发限流
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: 服务器内部错误，请稍后重试
          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&region=US&count=10' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - 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 <YOUR_API_KEY>'}
            )
            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 <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。
        可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。

````