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.
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 }}