API referenceTikTok
TikTok details (v1)
One TikTok video or photo post, in the standard content shape.
Reads a single post from its URL and returns it in the standardised shape, with view, like, comment and share counts, the caption, hashtags and the media URLs.
Set include_transcript to attach the caption track as flattened text.
It is slower, and comes back null when the video has no
captions.
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" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.tiktok.com/@police.pet.coolff/video/7625528457237155086" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "additional": { "creator_id": "7592563076018471950", "creator_nickname": "fendo200", "shop_products": [], "video_duration_seconds": 20, "video_height": null, "video_width": null }, "main": { "caption": "#tiktokshop #fyp #tiktokmademebuyit #freeshipping #safety ", "comment_count": 1, "creator_handle": "police.pet.coolff", "hashtags": [ "tiktokshop", "fyp", "… 3 more items in the full response" ], "like_count": 41, "post_id": "7625528457237155086", "post_url": "https://www.tiktok.com/@police.pet.coolff/video/7625528457237155086", "profile_picture_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ca216051e75654a60ae079d855f0c218~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_token=a7b99c11&x-expires=1787572800&x-signature=Sbkb%2BD3a7LJxedS0zqGBBLn91WQ%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&sc=avatar&s=AWEME_DE… (+4 chars)", "region": "US", "save_count": 13, "share_count": 4, "shop_product_url": null, "thumbnail_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ow7JgkkjfIdqSOGmHWALupf2QeowTdICdFPLmA~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&refresh_token=5ae7178d&x-expires=1787572800&x-signature=sCo5piJMf6yqYTLCCw1xhev%2FtZI%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&s=AWEME_DETAIL&s… (+24 chars)", "upload_timestamp": 1775456759, "video_url": "https://v16.tokcdn.com/80d18d4f3ba81c1b456fde15a79cd29b/69d2f780/7625528457237155086_original.mp4", "video_urls_by_quality": { "high": "https://v16.tokcdn.com/80d18d4f3ba81c1b456fde15a79cd29b/69d2f780/7625528457237155086_original.mp4", "low": null, "medium": "https://v16m.tiktokcdn-us.com/2bb39d2027974c635f338ed79c79c1a1/6a8b35c1/video/tos/useast5/tos-useast5-ve-0068c002-tx/oYd4p1QpDIWASmlHATFgS1RuXBffpEDQEUgOE0/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&&bt=909&ft=kLx3-yt4ZZo0PDTS0f3aQ9mdU~j6JE.C~&mime_type=video_mp4&rc=aDw3Nmc4ODNoZTVpOGdoNUBpamVqPGw5cnVvOjMzZzczNEA1L2E… (+108 chars)", "watermarked": "https://v16m.tiktokcdn-us.com/5064e9b218e5b7866311456c9dafbebd/6a8b35c1/video/tos/useast5/tos-useast5-ve-0068c001-tx/oE0c47UiavHEBBnJC7RgrAErTydQIgNqBUip8/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&&bt=827&ft=kLx3-yt4ZZo0PDTS0f3aQ9mdU~j6JE.C~&mime_type=video_mp4&rc=NDVnZWU8aGk3OGQzODxkOkBpamVqPGw5cnVvOjMzZzczNEBgLjE0… (+107 chars)" }, "view_count": 4597 } } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-details", "billable": true, "duration_ms": 896 }}