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 costs an extra fetch, and comes back null when the video has no
captions.
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 1.4s.
Authorization
ApiKeyAuth 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 }}