Coding with AI?
Connect your agent to our MCP and let it integrate any endpoint for you in one shot.
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
}