JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/tiktok/profile with Content-Type: application/json and your Authorization: Bearer header.
{
"handle": "tiktok"
}// request reference
TikTok Profile parameters
Send query parameters with GET /api/tiktok/profile. 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
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 user, stats, submit_feedback_for_this_response_here.
Failed requests return status 503 with {"error":"Service unavailable"} and are not billed.
Example successful response.
{
"user": {
"id": "107955",
"uniqueId": "tiktok",
"nickname": "TikTok",
"signature": "Your next discovery is waiting on TikTok.",
"verified": true,
"privateAccount": false
},
"stats": {
"followerCount": 96100000,
"followingCount": 1,
"heart": 465300000,
"heartCount": 465300000,
"videoCount": 1512,
"diggCount": 0,
"friendCount": 1
},
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}