Skip to main content
GET
/
api
/
v1
/
search
/
users
Search for users by keyword
curl --request GET \
  --url https://full-tiktok-api.p.rapidapi.com/api/v1/search/users \
  --header 'x-rapidapi-key: <api-key>'
{
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2025-03-12T14:32:01.498Z",
    "cached": false,
    "version": "2025-01"
  },
  "data": [
    {
      "user_id": "107955",
      "username": "charlidamelio",
      "display_name": "charli d'amelio",
      "website_url": "https://charlidamelio.com",
      "followers": 155000000,
      "following": 1200,
      "total_likes": 11000000000,
      "total_videos": 2400,
      "verified": true,
      "is_private": false,
      "bio": "just a girl who loves to dance",
      "avatar_url": "https://p16-sign.tiktokcdn-us.com/...",
      "avatar_thumb_url": "https://p16-sign.tiktokcdn-us.com/..."
    }
  ],
  "pagination": {
    "cursor": "1778971238000",
    "has_more": true
  },
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found.",
    "details": null
  }
}
Returns a paginated list of TikTok users matching the keyword. Equivalent to TikTok’s user/account search tab.

Authorizations

x-rapidapi-key
string
header
required

Your RapidAPI subscription key. Injected automatically by the RapidAPI gateway in production.

Query Parameters

keyword
string
required

Search term. Also accepted as ?q=

cursor
string

Opaque base64 pagination token returned by the previous response. Encodes both the offset and the search session ID required by the upstream API.

Response

Success

meta
object

Response metadata present in every API response

data
object[]
pagination
object

Cursor-based pagination info

error
object

Error details. Present only when the request failed; null on success.