Search creator accounts

GET/v1/user/search1 Credit / user (min 10 Credits)($0.10 / 1K users)

Discover TikTok creators by keyword with optional filters for follower tier and verification status. Paginated via cursor and has_more.

Query Parameters

keywordsstringrequired
Search keywords or username query.
Example: ai
cursorinteger
Pagination cursor (0 for first page, then pass data.cursor).
Example: 0
follower_countinteger
Follower count tier: 0 = Any, 1 = 0–1K, 2 = 1K–10K, 3 = 10K–100K, 4 = 100K+.
Example: 0
profile_typeinteger
Verification filter: 0 = Any, 1 = Verified accounts only.
Example: 0
search_emphasisinteger
Search scope: 0 = General, 1 = Username match only.
Example: 0

Example Request (cURL / Python / JavaScript)

curl "https://api.shortvidapi.com/v1/user/search?keywords=ai" \
  -H "x-api-key: tk_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://shortvidapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "user_list": [
      {
        "user": {
          "id": "7256182609359995947",
          "region": "CA",
          "uniqueId": "chatgpt",
          "nickname": "ChatGPT",
          "avatarThumb": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my&ps=13740610&refresh_token=be866962&shcp=c1333...",
          "avatarMedium": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=59bd7ce1&x-expires=1793631600&x-signature=SxAMOUk5WsFU5Y24xQsQsacYxBM...",
          "avatarLarger": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=8a375031&x-expires=1793631600&x-signature=Iprj7xQFDR0oayzEnnB5qX2Od...",
          "signature": "What can I help you with?",
          "verified": true,
          "secUid": "MS4wLjABAAAAT4vq3vsh9X-Vb_WtV6tz4QWTbKjliTKCiK5DqnJNtQEA2RUveHb7UdnL7xgPK2HB",
          "secret": false,
          "ftc": false,
          "relation": 0,
          "openFavorite": null,
          "commentSetting": 0,
          "duetSetting": 0,
          "stitchSetting": 0,
          "privateAccount": false,
          "isADVirtual": false,
          "isUnderAge18": false,
          "ins_id": "",
          "twitter_id": "",
          "youtube_channel_title": "",
          "youtube_channel_id": ""
        },
        "stats": {
          "followingCount": 1,
          "followerCount": 4126664,
          "heartCount": 20562859,
          "videoCount": 877,
          "diggCount": 3713,
          "heart": 20562859
        }
      },
      {
        "user": {
          "id": "7544448951454860310",
          "region": "SS",
          "uniqueId": "ai602509",
          "nickname": "AI",
          "avatarThumb": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee6d1b1c5d90b01fe46fd551b3d94fb7~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my&ps=13740610&refresh_token=bd30b55d&shcp=c1333...",
          "avatarMedium": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee6d1b1c5d90b01fe46fd551b3d94fb7~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=08be7ce2&x-expires=1793631600&x-signature=wT8CYSBimiXvvDhe2l4HJDo5H0M...",
          "avatarLarger": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee6d1b1c5d90b01fe46fd551b3d94fb7~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=d9744b28&x-expires=1793631600&x-signature=NVxDYdyrJ61Gj3eijzXE%2FpH...",
          "signature": "🎬 كل شيء هنا للضحك والترفيه – خذ الأمور بروح مرحة",
          "verified": false,
          "secUid": "MS4wLjABAAAApoqiVd0O_Fh8Zpz4LnMS9BNoWWOBKJZQaHA6FJamjtmOBxR1jNmz-vFZV5FJJy6H",
          "secret": false,
          "ftc": false,
          "relation": 0,
          "openFavorite": null,
          "commentSetting": 0,
          "duetSetting": 0,
          "stitchSetting": 0,
          "privateAccount": false,
          "isADVirtual": false,
          "isUnderAge18": false,
          "ins_id": "",
          "twitter_id": "",
          "youtube_channel_title": "",
          "youtube_channel_id": ""
        },
        "stats": {
          "followingCount": 1967,
          "followerCount": 186838,
          "heartCount": 851938,
          "videoCount": 357,
          "diggCount": 4489,
          "heart": 851938
        }
      }
    ],
    "cursor": 10,
    "hasMore": true
  }
}

Response Fields

Success (code === 0). Charged according to the endpoint credit rate.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string	Example: https://shortvidapi.com
`status`	string	Example: ok
`msg`	string	Example: success
`data`	object
`user_list`	array of object
`user`	object
`stats`	object
`cursor`	integer	Example: 10
`hasMore`	boolean	Example: true

Status Codes

200: Success (code === 0). Charged according to the endpoint credit rate.
400: Invalid parameters, or API key placed in the URL query string (not charged).
401: Missing or invalid x-api-key header (not charged).
402: Insufficient credit balance (not charged).
403: Account disabled (not charged).
404: Unknown endpoint or disabled unstable endpoint (not charged).
405: Method not allowed — all /v1/* data endpoints use GET (not charged).
429: Rate limit exceeded (not charged). Respect the Retry-After header.
503: Temporary upstream or gateway error (not charged). Retry with exponential backoff.

Migrating from direct scraping and hitting HTTP 403 Forbidden or empty responses on www.tiktok.com? Read How to Fix TikTok HTTP Error 403 or compare quota limits in our TikTok API Quota & Cost Calculator.