TikTok
TikTok transcript API
Get what a TikTok video says, from captions or its own audio. Call the TikTok transcript API for JSON. From 1 credit per call.
POST
Get what a TikTok video says, from captions or its own audio
Returns what a TikTok video says, from captions or its own audio. The video is identified by its URL or ID.
Request
Exactly one ofvideoUrl or videoId is required. A request that sets both, or none, fails with invalidRequest.
Response
If successful, the response body contains the standard envelope.data contains what the video says as one block of text.
The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.
Optional parameters
Videos longer than 3 minutes are rejected with
invalidRequest. Rejected requests are not billed.Billing
A successful request consumes 1 credit when the video has captions; otherwise 2 credits plus 1 credit for every 10 seconds of audio, up to 3 minutes, up to 20 credits. Requests that fail, or that return no items, are not billed.Pagination
This method is not paginated. A single request returns the complete result.Related methods
- TikTok video: Accepts
videoUrl. Returns a video’s caption, stats and music. - TikTok comments: Accepts
videoUrl. Returns a video’s comments, or the replies to one comment.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Link to the TikTok video, like https://www.tiktok.com/@khaby.lame/video/7137423965982592302. Send this or videoId.
TikTok video id, like 7137423965982592302. Send this or videoUrl.
BCP 47 language tag, e.g. en or pt-BR. Any case is accepted.
Pattern:
^[A-Za-z]{2,3}(?:[-_][A-Za-z0-9]{2,4})?$