Appearance
Get popular creators
GET /v1/tiktok/creators/popular
Discovers trending and popular TikTok creators, filterable by follower count range, creator country, and audience country. Returns creator_list, an array of creator objects each with nickname, unique_id, follower_count, likes_count, video_views, engagement_rate, and avatar URLs. Sortable by engagement, follower count, or average views.
Authentication
All requests require the x-api-key header. Get your key at scrapecreators.com.
Query Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
page | number | no | Page number | 1 |
sortBy | enum(engagement, follower, avg_views) | no | Sort creators by engagement, follower count, or average views | engagement |
followerCount | enum(10K-100K, 100K-1M, 1M-10M, 10M+) | no | Filter by follower count range | 10K-100K |
creatorCountry | enum(AU, BR, CA, EG, FR, DE, ID, IL, IT, JP, MY, PH, RU, SA, SG, KR, ES, TW, TH, TR, AE, GB, US, VN) | no | Country code of the creator | US |
audienceCountry | enum(AU, BR, CA, EG, FR, DE, ID, IL, IT, JP, MY, PH, RU, SA, SG, KR, ES, TW, TH, TR, AE, GB, US, VN) | no | Country code of the audience/follower | US |
Example Request
curl
bash
curl 'https://api.scrapecreators.com/v1/tiktok/creators/popular' \
-H 'x-api-key: $SCRAPECREATORS_API_KEY'Node / TypeScript
js
const params = new URLSearchParams({ });
const res = await fetch(`https://api.scrapecreators.com/v1/tiktok/creators/popular?${params}`, {
headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY }
});
const data = await res.json();
console.log(data);Python
python
import os, requests
r = requests.get(
'https://api.scrapecreators.com/v1/tiktok/creators/popular',
headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
params={},
)
r.raise_for_status()
print(r.json())CLI
bash
scrapecreators tiktok creators-popular --helpExample Response
json
{
"success": true,
"credits_remaining": 100,
"creators": [
{
"tcm_id": "7377026041014927376",
"user_id": "6620098253516439554",
"nick_name": "SANIEV",
"avatar_url": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/e2699c87b4fe37f8fc4d65a7dc453786~tplv-tiktokx-cropcenter:100:100.png?dr=14579&refresh_token=db296f9e&x-expires=1768082400&x-signature=JL5qjD7FOX%2FF4ML6XbWBeose9Zc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=317596d8&idc=my",
"country_code": "US",
"follower_cnt": 431339,
"liked_cnt": 129772610,
"tt_link": "https://www.tiktok.com/@sanievv_",
"tcm_link": "https://creatormarketplace.tiktok.com/ad#/author/7377026041014927376",
"items": [
{
"item_id": "7395965676629888274",
"cover_url": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-p-0037/9f078a63ecd74061b52172692e1f5600_1722007460~tplv-noop.image?dr=18692&refresh_token=d96f1adb&x-expires=1767931908&x-signature=QxvUl2ljXqt1iR6wt8FVfohlkAg%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my",
"tt_link": "https://www.tiktok.com/@author/video/7395965676629888274",
"vv": 2062831,
"liked_cnt": 229970,
"create_time": 1722007452
}
]
}
],
"pagination": {
"page": 1,
"size": 20,
"total": 10,
"has_more": false
}
}Credits
Most ScrapeCreators endpoints consume 1 credit per successful response. Some heavier endpoints (transcripts, AI-driven enrichment, ad detail lookups) may cost more. Check GET /v1/credit-balance for your remaining balance.
Errors
| Status | Meaning | Action |
|---|---|---|
| 200 | Success. | Use the JSON payload. |
| 400 | Invalid or missing parameter. | Verify required parameters and value format. |
| 401 | Missing or invalid x-api-key. | Pass a valid API key in the header. |
| 402 | Out of credits. | Top up at scrapecreators.com or wait for plan reset. |
| 404 | Resource not found or private. | Confirm the handle, URL, or id and that the resource is public. |
| 429 | Rate limited. | Backoff and retry with exponential delay. |
| 500 | Server error or upstream platform failure. | Retry with backoff; report persistent errors to support. |