TikTok Users
Search TikTok users by keyword. Returns username, nickname, bio, follower/following counts, total likes, video count, and verification status. Supports fetching multiple pages in a single API call.
Endpoint
GET /v1/tiktok/users
Price: $0.006 per page Free tier: 50 requests/month
Parameters
| Parameter | Required | Description |
|---|---|---|
query |
Yes | Search keyword (max 500 characters) |
pages |
No | Number of pages to fetch, 1-10 (default: 1) |
Response Fields
| Field | Type | Description |
|---|---|---|
users |
array | Array of matching user profiles |
users[].username |
string | TikTok username (unique ID) |
users[].nickname |
string | Display name |
users[].user_id |
string | TikTok user ID |
users[].bio |
string | Profile bio / signature |
users[].verified |
boolean | Whether the user is verified |
users[].is_private |
boolean | Whether the account is private |
users[].followers |
integer | Number of followers |
users[].following |
integer | Number of accounts followed |
users[].likes |
integer | Total likes received |
users[].video_count |
integer | Number of videos posted |
users[].avatar |
string | URL to profile picture |
users[].url |
string | Link to the profile |
pages |
integer | Number of pages fetched |
count |
integer | Total results returned |
Example Request
cURL
curl "https://apidirect.io/v1/tiktok/users?query=cooking&pages=1" \
-H "X-API-Key: YOUR_API_KEY"
Python
import requests
response = requests.get(
"https://apidirect.io/v1/tiktok/users",
headers={"X-API-Key": "YOUR_API_KEY"},
params={
"query": "cooking",
"pages": 1
}
)
print(response.json())
Example Response
{
"users": [
{
"username": "cookingwithshereen",
"nickname": "Shereen Pavlides",
"user_id": "6812601268610257926",
"bio": "Chef | Author | TV Host",
"verified": true,
"is_private": false,
"followers": 483313,
"following": 47,
"likes": 3090163,
"video_count": 728,
"avatar": "https://p16-sign.tiktokcdn-us.com/.../photo.webp",
"url": "https://www.tiktok.com/@cookingwithshereen"
}
],
"pages": 1,
"count": 30
}