TikTok API: List suggested accounts (v3)

List accounts TikTok suggests as similar to an account, with their counts. Paginate with cursor and has_more. An unknown account returns data: null.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

sec_uid*string

Account sec_uid, from /v3/tiktok/user or the author of any video.

Match^[A-Za-z0-9_-]{20,200}$

count?integer

Items to request per page, 1 to 50. A page can hold fewer.

Range1 <= value <= 50

Default30

cursor?string

cursor from the previous response. Omit for the first page and send it unchanged for later pages.

Length1 <= length <= 1000

curl -X GET "https://example.com/v3/tiktok/user/suggested?sec_uid=MS4wLjABAAAAU9BRVzC8oCaegVnia8IbqWhPb_-dbU7s00Y3wS1_Nx8g5RUaYvyXrpejgjdxTwd6" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "items": [      {        "id": "86328792343818240",        "sec_uid": "MS4wLjABAAAA-0bQT0CqebTRr6I4IkYvMDMKSRSJHLNPBo5HrSklJwyA2psXLSZG5FP-LMNpHnJd",        "username": "tatemcrae",        "nickname": "tate mcrae",        "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/9ca5cba8704946216a09563671107e4d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=9269bdd5&x-expires=1792335600&x-signature=1Mtu8E%2FvMeZwBcano4VgtbN%2F1%2FU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",        "verified": true,        "bio": "23",        "private": false,        "followers": 13900000,        "following": 476,        "likes": 586000000,        "videos": 1229,        "bio_link": null,        "region": null      },      {        "id": "7047450743465477126",        "sec_uid": "MS4wLjABAAAAhxvSFp8FPW1xhPCzgTzExrCo7Onwd2CuvldSXoUM5oSMLsfR8p6wBNMiWVgBg6V_",        "username": "badbunny",        "nickname": "Bad Bunny",        "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310298084372660270~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=7ba31e9a&x-expires=1792335600&x-signature=Ax27YQyf%2FXZVEJ8MRSasBHxId2g%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",        "verified": true,        "bio": ".",        "private": false,        "followers": 41400000,        "following": 0,        "likes": 445500000,        "videos": 11,        "bio_link": null,        "region": null      }    ],    "count": 2,    "cursor": null,    "has_more": false  }}