JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/tiktok/transcript with Content-Type: application/json and your Authorization: Bearer header.
{
"url": "https://www.tiktok.com/@davidteathercodes/video/7106686413101468970"
}// request reference
TikTok Transcript parameters
Send query parameters with GET /api/tiktok/transcript. 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
urlTikTok video, photo/slideshow or vm/vt short-link URL.
Type string · GET query or POST JSON
- Maximum characters: 2048
video_idTikTok post ID; supply this or url.
Type string · GET query or POST JSON
- Pattern: ^[0-9]{1,25}$
languageCaption language code, for example eng-US. Defaults to the first available track.
Type string · GET query or POST JSON
- Pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$
// 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 language, text, segments, submit_feedback_for_this_response_here.
Failed requests return status 503 with {"error":"Service unavailable"} and are not billed.
Example successful response.
{
"language": "eng-US",
"text": "did you know\nthat it's really easy to make QR codes in Python?\nenlighten me.\njust run pip,\ninstall QR code,\nthen in a text editor, import QR code.\nnext you can pass the data you want\nstored in the QR code to the make function.\nfinally, save your QR code to a file.\nthat's how it's done.",
"segments": [
{
"start": 0.04,
"end": 0.399,
"text": "did you know"
},
{
"start": 0.4,
"end": 2.479,
"text": "that it's really easy to make QR codes in Python?"
},
{
"start": 2.48,
"end": 3.599,
"text": "enlighten me."
},
{
"start": 3.6,
"end": 4.359,
"text": "just run pip,"
},
{
"start": 4.36,
"end": 5.319,
"text": "install QR code,"
},
{
"start": 5.32,
"end": 7.559,
"text": "then in a text editor, import QR code."
},
{
"start": 7.56,
"end": 8.999,
"text": "next you can pass the data you want"
},
{
"start": 9,
"end": 10.959,
"text": "stored in the QR code to the make function."
},
{
"start": 10.96,
"end": 13.5,
"text": "finally, save your QR code to a file."
},
{
"start": 13.72,
"end": 15.14,
"text": "that's how it's done."
}
],
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}