API referenceTikTok
TikTok details (v3)
One TikTok post with subtitles, transcript and resolved mentions.
The same target as tiktok-details, with more fields available.
include_subtitles fills subtitles, media dimensions, content language,
visual effects and location. include_transcript also flattens the
caption track into text. resolve_mentions turns the display names in a
caption into the creators' actual handles.
Each flag adds a fetch, so turn on only the ones you need. Where several are set they share the same fetch rather than each paying for one.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 12.3s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/tiktok-details-v3" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.tiktok.com/@tiktok/video/7646496890783010078", "include_transcript": true }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "post": { "advertisement_status": false, "age_restriction_status": null, "author_avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_token=50133581&x-expires=1787572800&x-signature=IwKz5R0iqEH6f4aFxZyMYhzO9bk%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&sc=avatar&s=AWEME_DETA… (+2 chars)", "author_id": "107955", "author_name": "TikTok", "author_username": "tiktok", "caption": "one museum walkthrough away from becoming the friend who says “the composition here is stunning” #MuseumsComeAlive", "categories": [ "Movies & TV works", "Entertainment Culture", "… 1 more item in the full response" ], "child_content": null, "comment_count": 2304, "commenting_status": "enabled", "content_code": "v15044gf0000d8esug7og65kg1u2r1jg", "content_id": "7646496890783010078", "content_language": "en", "content_link": "https://www.tiktok.com/@tiktok/video/7646496890783010078", "content_type": "video", "download_count": 74, "extracted_text": null, "file_size_bytes": 10124878, "first_comment": null, "hashtags": [ "MuseumsComeAlive" ], "images": [], "like_count": 11695, "location": "US", "media_height": 1280, "media_links": { "audio": "https://v16-ies-music.tiktokcdn-us.com/c552d50b30a90fbd26a64b396bc24961/6a941c5d/video/tos/useast8/tos-useast8-v-27dcd7-tx2/oIxgqQfggyoQUNdFf37Y4QYmH7JuAb0AEefoxP/?a=583965&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&&bt=125&ft=7g~atDDwNxkVQQdGuIOnsd1euXZqYltbjLI~hWLrK&mime_type=audio_mpeg&rc=PGQ0ODM0OmQ5NGY7PDs8ZkBpM3l0bHQ5c… (+146 chars)", "high": "https://v16.tokcdn.com/ca6809aebdc931bfdbc1ee0e1cf0a276/6a1ccb80/7646496890783010078_original.mp4", "low": null, "medium": "https://v16m.tiktokcdn-us.com/7e42e6ac80cb39753d1dd4f93f466420/6a8b35f5/video/tos/useast8/tos-useast8-ve-0068c002-tx2/oYfqQbR4EjDHh7fEgoF9AQTTEOTPIABpcDgVAA/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&&bt=1089&ft=74~WHDDwNxkVQQdGuIOnsd1euXZqYltbjLI~hWLrK&mime_type=video_mp4&rc=PDw7PDpkZTczaGc1OWZmM0BpajQ1NG45cmp2OzMza… (+118 chars)", "watermarked": "https://v16m.tiktokcdn-us.com/a28246ce0bad4eebb52fdb52519293ff/6a8b35f5/video/tos/useast8/tos-useast8-ve-0068c002-tx2/ok9HDfpAEEeVIaoDAgqAFBP7QPRcAIbOQEDShK/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&&bt=1022&ft=74~WHDDwNxkVQQdGuIOnsd1euXZqYltbjLI~hWLrK&mime_type=video_mp4&rc=Nzo1OGlpOTZpOzZmZTxlZUBpajQ1NG45cmp2OzMza… (+118 chars)" }, "media_width": 720, "mentions": [], "music_information": { "album": null, "author": "TikTok", "cover_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token=26fee8ab&x-expires=1787572800&x-signature=FfpJBD0%2Fs9y%2Foefe3u%2FeQt05H5A%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&sc=avatar&s=AW… (+10 chars)", "duration_seconds": 72, "id": "7646496939407690527", "is_original": true, "play_url": "https://v16-ies-music.tiktokcdn-us.com/c552d50b30a90fbd26a64b396bc24961/6a941c5d/video/tos/useast8/tos-useast8-v-27dcd7-tx2/oIxgqQfggyoQUNdFf37Y4QYmH7JuAb0AEefoxP/?a=583965&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&&bt=125&ft=7g~atDDwNxkVQQdGuIOnsd1euXZqYltbjLI~hWLrK&mime_type=audio_mpeg&rc=PGQ0ODM0OmQ5NGY7PDs8ZkBpM3l0bHQ5c… (+146 chars)", "title": "original sound - tiktok" }, "pinned_status": false, "published_date": 1780338809, "region": "US", "save_count": 1097, "share_count": 995, "shop_products": [], "slideshow_status": false, "sponsorship_status": false, "subtitles": [ { "format": "webvtt", "is_auto_generated": true, "kind": "auto", "language_code": "eng-US", "language_name": "eng-US", "url": "https://v16m-webapp.tiktokcdn-us.com/cf0c3eb905cd513fcc114b040ee06367/6a8d849d/video/tos/useast8/tos-useast8-v-0068-tx2/fa3f24c4faba41968b80691ae79a2e49/?a=1988&bti=ODszNWYuMDE6&&bt=14624&ft=4KLMeMzm8Zmo0hOmxa4jVhsadpWrKsd.&mime_type=video_mp4&rc=ajQ1NG45cmp2OzMzaTczNEBpajQ1NG45cmp2OzMzaTczNEBnb3JkMmQ0cmJhLS1kMTJzYSNnb… (+79 chars)" } ], "tagged_users": [], "thumbnail_image": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osAbAf97DEAqFAEE37EodOIOHCVQ90tAn5RfBA~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&refresh_token=4bd7c78a&x-expires=1787572800&x-signature=gudWs%2BlWvkaZXG0gQM%2FXXp4dNyU%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&biz_tag=tt_vi… (+27 chars)", "transcript": "Hi, I'm Kate Bartlett, and I'm here at the museum of Modern Art in New York for TikTok Lives Museums come alive series. Today, I'm here with Arlette, who is giving me a tour and showing me some of the most incredible works that are here at MOMA. We think that you don't need to know everything about art to really enjoy … (+922 chars)", "transcript_language": "eng-US", "video_duration_seconds": 72, "video_link": "https://v16.tokcdn.com/ca6809aebdc931bfdbc1ee0e1cf0a276/6a1ccb80/7646496890783010078_original.mp4", "view_count": 224170, "visual_effects": null } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-details-v3", "billable": true, "duration_ms": 11814 }}