← API Store
Social
TikTok
TikTok
Search TikTok accounts
GET /tiktok/v1/search/usersEvery response includes credits_used: the credits this call cost.
TikTok's users-only search is empty for logged-out visitors, so this reads the accounts in the Top results.
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: cooking |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 12,
"credits_used": 1,
"next_cursor": "12|202610231946305E4C105E73C5764ECE4C",
"query": "cooking",
"users": [
{
"avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/00de3c4a91029fd7f9d74eacce08dc33~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&…",
"avatars": {
"larger": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/00de3c4a91029fd7f9d74eacce08dc33~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&…",
"medium": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/00de3c4a91029fd7f9d74eacce08dc33~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&re…",
"thumb": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/00de3c4a91029fd7f9d74eacce08dc33~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&re…"
},
"bio_link": null,
"commerce": null,
"created_at": null,
"followers": 79600,
"following": 118,
"friends": 0,
"id": "7427898099555386373",
"language": null,
"likes": 432000,
"likes_given": 270,
"matched": "video",
"nickname": "Pink Cat Power",
"organization": null,
"private": false,
"raw_stats": {
"diggCount": 270,
"followerCount": 79600,
"followingCount": 118,
"friendCount": 0,
"heart": 432000,
"heartCount": 432000,
"videoCount": 82
},
"region": null,
"sec_uid": "MS4wLjABAAAAhjO8aFDajn8RIFvw8lNUcqic1wgoGmDvzeqVZyGXLSRpL9E_6xk887a6f3a_AJOr",
"secret": false,
"signature": "",
"url": "https://www.tiktok.com/@alex.m5764",
"username": "alex.m5764",
"verified": false,
"videos": 82
},
{
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"avatars": {
"larger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"medium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9…",
"thumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9…"
},
"bio_link": null,
"commerce": null,
"created_at": null,
"followers": 15300,
"following": 0,
"friends": 0,
"id": "7659299286202729485",
"language": null,
"likes": 133100,
"likes_given": 0,
"matched": "video",
"nickname": "boieqmdk8rc",
"organization": null,
"private": false,
"raw_stats": {
"diggCount": 0,
"followerCount": 15300,
"followingCount": 0,
"friendCount": 0,
"heart": 133100,
"heartCount": 133100,
"videoCount": 38
},
"region": null,
"sec_uid": "MS4wLjABAAAAz96wnaw0Rqe5nl_CInRMfmeDtaDa3LXxTQ7ZOIfZ7HrfBQaewFQtDUWmqWRLZ49Q",
"secret": false,
"signature": "",
"url": "https://www.tiktok.com/@boieqmdk8rc",
"username": "boieqmdk8rc",
"verified": false,
"videos": 38
},
"… 10 more"
]
} Response fields (43)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.query | string |
$.users | array |
$.users[] | object | string |
$.users[].avatar | string |
$.users[].avatars | object |
$.users[].avatars.larger | string |
$.users[].avatars.medium | string |
$.users[].avatars.thumb | string |
$.users[].bio_link | null |
$.users[].commerce | null |
$.users[].created_at | null |
$.users[].followers | integer |
$.users[].following | integer |
$.users[].friends | integer |
$.users[].id | string |
$.users[].language | null |
$.users[].likes | integer |
$.users[].likes_given | integer |
$.users[].matched | string |
$.users[].nickname | string |
$.users[].organization | null |
$.users[].private | boolean |
$.users[].raw_stats | object |
$.users[].raw_stats.diggCount | integer |
$.users[].raw_stats.followerCount | integer |
$.users[].raw_stats.followingCount | integer |
$.users[].raw_stats.friendCount | integer |
$.users[].raw_stats.heart | integer |
$.users[].raw_stats.heartCount | integer |
$.users[].raw_stats.videoCount | integer |
$.users[].region | null |
$.users[].sec_uid | string |
$.users[].secret | boolean |
$.users[].signature | string |
$.users[].url | string |
$.users[].username | string |
$.users[].verified | boolean |
$.users[].videos | integer |