Search APIs
Loading…
← API Store
Social

TikTok

TikTok

Search TikTok accounts

GET /tiktok/v1/search/users
Test this endpoint

Every 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

NameTypeDescription
qrequiredstring Example: cooking
cursorstringValue 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.next_cursorstring
$.querystring
$.usersarray
$.users[]object | string
$.users[].avatarstring
$.users[].avatarsobject
$.users[].avatars.largerstring
$.users[].avatars.mediumstring
$.users[].avatars.thumbstring
$.users[].bio_linknull
$.users[].commercenull
$.users[].created_atnull
$.users[].followersinteger
$.users[].followinginteger
$.users[].friendsinteger
$.users[].idstring
$.users[].languagenull
$.users[].likesinteger
$.users[].likes_giveninteger
$.users[].matchedstring
$.users[].nicknamestring
$.users[].organizationnull
$.users[].privateboolean
$.users[].raw_statsobject
$.users[].raw_stats.diggCountinteger
$.users[].raw_stats.followerCountinteger
$.users[].raw_stats.followingCountinteger
$.users[].raw_stats.friendCountinteger
$.users[].raw_stats.heartinteger
$.users[].raw_stats.heartCountinteger
$.users[].raw_stats.videoCountinteger
$.users[].regionnull
$.users[].sec_uidstring
$.users[].secretboolean
$.users[].signaturestring
$.users[].urlstring
$.users[].usernamestring
$.users[].verifiedboolean
$.users[].videosinteger