JSON POST request example
POST to https://api.litescrape.com/api/tiktok/followers with Content-Type: application/json and your Authorization: Bearer header.
{
"handle": "tiktok",
"count": 3
}// request reference
TikTok Followers parameters
Send query parameters with GET /api/tiktok/followers. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Request parameters
cursorUpstream pagination cursor from the preceding response; 0 starts a new feed.
Type string | integer · GET query or POST JSON · Default 0
- Pattern: ^[0-9]{1,25}$ (string)
- Minimum: 0 (integer)
- Maximum: 9223372036854775807 (integer)
countRequested page size, between 1 and 35.
Type integer · GET query or POST JSON · Default 20
- Minimum: 1
- Maximum: 35
handlePublic TikTok handle, with or without @; supply this or user_id.
Type string · GET query or POST JSON
- Pattern: ^@?[A-Za-z0-9_.]{1,24}$
user_idNumeric TikTok user ID; supply this or handle.
Type string · GET query or POST JSON
- Pattern: ^[0-9]{1,25}$
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include has_more, cursor, total, users, submit_feedback_for_this_response_here.
Failed requests return status 503 with {"error":"Service unavailable"} and are not billed.
Example successful response.
{
"has_more": true,
"cursor": "1791610646",
"total": 96149882,
"users": [
{
"stats": {
"diggCount": 9064,
"followerCount": 1032,
"followingCount": 588,
"friendCount": 0,
"heart": 4758,
"heartCount": 4758,
"videoCount": 18
},
"statsV2": {
"diggCount": "9064",
"followerCount": "1032",
"followingCount": "588",
"friendCount": "0",
"heart": "4758",
"heartCount": "4758",
"videoCount": "18"
},
"user": {
"id": "7651766998866969621",
"nickname": "ِ-𝑬َ𝓁ِ𝕖𝕖ِ𝕟٫َ𓆩𓆙𓆪 َ.",
"uniqueId": "just._eleen",
"verified": false
}
},
{
"stats": {
"diggCount": 760,
"followerCount": 1535,
"followingCount": 459,
"friendCount": 0,
"heart": 219,
"heartCount": 219,
"videoCount": 7
},
"statsV2": {
"diggCount": "760",
"followerCount": "1535",
"followingCount": "459",
"friendCount": "0",
"heart": "219",
"heartCount": "219",
"videoCount": "7"
},
"user": {
"id": "6513443195308392450",
"nickname": "阿勝",
"uniqueId": "170_08_11_yongsheng",
"verified": false
}
},
{
"stats": {
"diggCount": 443,
"followerCount": 15200,
"followingCount": 25,
"friendCount": 0,
"heart": 2644,
"heartCount": 2644,
"videoCount": 5
},
"statsV2": {
"diggCount": "443",
"followerCount": "15181",
"followingCount": "25",
"friendCount": "0",
"heart": "2644",
"heartCount": "2644",
"videoCount": "5"
},
"user": {
"id": "7095675622291670018",
"nickname": "fatih_btfk_coach",
"uniqueId": "fatih_btfk_coach",
"verified": false
}
}
],
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}