TikTok Single Video Info
Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.
Overview
Section titled “Overview”Call GET /api/v2/tiktok-single-video-info/ with urls. The results are in data.video; send data.next_cursor back as cursor to get the next page. 5 optional parameters refine the call (see Parameters).
Request
Section titled “Request”curl -G "https://api.scrapier.io/api/v2/tiktok-single-video-info/" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "urls=https://www.tiktok.com/@scout2015/video/6718335390845095173" \ --max-time 210const params = new URLSearchParams({ urls: "https://www.tiktok.com/@scout2015/video/6718335390845095173" });
const res = await fetch(`https://api.scrapier.io/api/v2/tiktok-single-video-info/?${params}`, { headers: { "X-API-Key": "YOUR_API_KEY" }, signal: AbortSignal.timeout(210_000),});const body = await res.json();if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
console.log(body.data.video);import requests
resp = requests.get( "https://api.scrapier.io/api/v2/tiktok-single-video-info/", headers={"X-API-Key": "YOUR_API_KEY"}, params={"urls": "https://www.tiktok.com/@scout2015/video/6718335390845095173"}, timeout=210,)body = resp.json()if not resp.ok: raise RuntimeError(body.get("error") or body.get("detail"))
print(body["data"]["video"])curl -X POST "https://api.scrapier.io/api/v2/tiktok-single-video-info/" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urls":"https://www.tiktok.com/@scout2015/video/6718335390845095173"}' \ --max-time 210Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X-API-Key header | string | yes | — | Your API key from the dashboard. |
urls | string | yes | e.g. https://www.tiktok.com/@scout2015/video/6718335390845095173 | TikTok video / photo URL, vm./vt./tiktok.com/t/ short link, legacy m.tiktok.com/v/<id>.html or bare 19-digit id. Single lookup: the full record is returned under video, next_cursor is always null. |
cursor | string | no | — | Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page. |
include_transcript | boolean | no | true | Fetch + parse the WebVTT caption track (transcript text + transcript_info). |
include_media_urls | boolean | no | true | Attach download_media_urls (no-watermark mp4 / watermarked mp4 / carousel images as CDN URLs with the fetch_headers to download them). |
trim | boolean | no | false | true = condensed aweme_detail instead of the full 188-key record. |
complete_schema | boolean | no | true | Pad aweme_detail to the full native mobile-API schema. |
Advanced
| Name | Type | Default | Description |
|---|---|---|---|
use_proxy | boolean | true | Route the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise. |
raw_data | boolean | false | When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes. |
Response
Section titled “Response”{ "success": true, "data": { "urls": "https://www.tiktok.com/@natgeo/video/7683891628230315295", "video": { "input_url": "https://www.tiktok.com/@natgeo/video/7683891628230315295", "video_id": "7683891628230315295", "url": "https://www.tiktok.com/@natgeo/video/7683891628230315295", "resolved_url": null, "status": "ok", "success": true, "reason": null, "status_code": 0, "error": null, "aweme_detail": { "aweme_id": "7683891628230315295", "aweme_type": 0, "desc": "Presented by @ROLEX. Welcome to Africa 🌍 Africa Earth's Wild Home takes you deep into the heart of our wildest continent, bringing you closer to its animals, landscapes, and the people watching over it than ever before. Through its partnership with the National Geographic Society and as part of its Perpetual Planet Initiative, #Rolex supports expeditions exploring and protecting remarkable places around the world, a selection of which are featured in Africa Earth’s Wild Home. #PerpetualPlanet Africa Earth's Wild Home, narrated by Wunmi Mosaku, premieres Friday, October 2 at 8/7c on National Geographic. Streaming next day on @Disney+ and @hulu.", "desc_language": "en", "create_time": 1789045447, "create_time_utc": "2026-09-10T13:04:07.000Z", "region": "GB", "hashtags": [ "rolex", "perpetualplanet" ], "mentions": [ "rolex", "disneyplus", "hulu" ], "is_ad": false, "is_paid_partnership": false, "is_aigc": false, "author": { "uid": "6780344874811442181", "unique_id": "natgeo", "nickname": "National Geographic", "sec_uid": "MS4wLjABAAAAEf96k3JW8-3eOhgzgQswlFF6ZDnn1dzqWWorJjwDsiNZymqTtvOcFhp_RiYYST6s", "signature": "Step into wonder and find your inner explorer with National Geographic 🌎", "verified": true, "follower_count": 9600000, "following_count": 62, "aweme_count": 1505, "total_favorited": 54500000, "custom_verify": "Verified account", "region": "", "profile_url": "https://www.tiktok.com/@natgeo", "avatar_larger": { "data_size": 0, "height": 1080, "uri": "tos-maliva-avt-0068/324924e171e481040a1ea202962f6e07", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/324924e171e481040a1ea202962f6e07~tplv-tiktokx-cropce..." ], "url_prefix": null, "width": 1080 }, "...": "+110 more author keys (full mobile-API author card)" }, "author_stats": { "follower_count": 9600000, "following_count": 62, "heart_count": 54500000, "video_count": 1505, "digg_count": 3142, "friend_count": 0 }, "music": { "id": "7683891712992774942", "title": "original sound", "author": "National Geographic", "is_original_sound": true, "duration": 72, "album": "", "music_url": "https://www.tiktok.com/music/original-sound-7683891712992774942", "play_url": { "data_size": 0, "height": 0, "uri": "168b1a57b2141995684d74a7a2403974/6aafafe4/video/tos/alisg/to...", "url_list": [ "https://v16m.tiktokcdn.com/168b1a57b2141995684d74a7a2403974/6aafafe4/video/tos/alisg/tos-alisg-ve-2370c799-sg/..." ], "url_prefix": null, "width": 0 }, "cover_large": { "data_size": 0, "height": 1080, "uri": "tos-maliva-avt-0068/324924e171e481040a1ea202962f6e07", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/324924e171e481040a1ea202962f6e07~tplv-tiktokx-cropce..." ], "url_prefix": null, "width": 1080 }, "...": "+68 more music keys" }, "video": { "duration": 72000, "duration_seconds": 72, "width": 576, "height": 1024, "ratio": "540p", "has_watermark": false, "codec_type": "h264", "definition": "540p", "format": "mp4", "video_quality": "normal", "bitrate": 1465326, "size": 13301315, "cover": { "data_size": 0, "height": 0, "uri": "tos-useast8-p-0068-tx2/oMAACXiIEiA1iUUfjqiKiECG7sV2qCAqBBVIA...", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oMAACXiIEiA1iUUfjqiKiECG7sV2qCAqBBVIA8~tplv-tikto..." ], "url_prefix": null, "width": 0 }, "origin_cover": { "data_size": 0, "height": 0, "uri": "tos-useast8-p-0068-tx2/ocLRlIqwP6EqABiqiPBIpimKAEBaBVogslqXi", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocLRlIqwP6EqABiqiPBIpimKAEBaBVogslqXi~tplv-tiktok..." ], "url_prefix": null, "width": 0 }, "dynamic_cover": { "data_size": 0, "height": 0, "uri": "tos-useast8-p-0068-tx2/oMAACXiIEiA1iUUfjqiKiECG7sV2qCAqBBVIA...", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oMAACXiIEiA1iUUfjqiKiECG7sV2qCAqBBVIA8~tplv-tikto..." ], "url_prefix": null, "width": 0 }, "play_addr": { "data_size": 13301315, "height": 1024, "uri": "v15044gf0000dahag47og65gkpkkv5bg", "url_list": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIPvOIB5EwQMr2KB2AREqiVplFilPamEXoq..." ], "url_prefix": null, "width": 576 }, "download_no_watermark_addr": { "data_size": 13301315, "height": 1024, "uri": "v15044gf0000dahag47og65gkpkkv5bg", "url_list": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIPvOIB5EwQMr2KB2AREqiVplFilPamEXoq..." ], "url_prefix": null, "width": 576 }, "download_addr": null, "bit_rate": [ { "gear_name": "normal_540_0", "bit_rate": 1465326, "codec_type": "h264", "quality_type": 20, "is_bytevc1": 0, "fps": 23, "play_addr": { "data_size": 13301315, "height": 1024, "uri": "v15044gf0000dahag47og65gkpkkv5bg", "url_list": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIPvOIB5EwQMr2KB2AREqiVplFilPamEXoq..." ], "url_prefix": null, "width": 576 } }, "... one entry per gear" ], "cla_info": { "caption_infos": [ { "language": "eng-US", "language_code": "en", "is_auto_gen": true, "is_original_caption": true, "caption_format": "webvtt", "url": "https://v16-webapp.tiktok.com/709bbbc7b5ba5d10b7dceb0580a06776/6ab10164/video/tos/alisg/tos-alisg-v-37c799-sg/..." } ], "enable_auto_caption": true, "has_original_audio": true, "no_caption_reason": 0, "original_language_info": { "language": "eng-US", "language_id": "2", "language_code": "en", "can_translate_real_time_no_check": true } }, "...": "+20 more video keys (zoom_cover, share_cover, subtitle_infos, volume_info, ...)" }, "statistics": { "aweme_id": "7683891628230315295", "collect_count": 999, "comment_count": 286, "digg_count": 17400, "download_count": 0, "forward_count": 0, "lose_comment_count": 0, "lose_count": 0, "play_count": 121400, "repost_count": 0, "share_count": 526, "whatsapp_share_count": 0 }, "status": { "allow_comment": true, "allow_share": true, "aweme_id": "7683891628230315295", "download_status": 0, "in_reviewing": false, "is_delete": false, "is_prohibited": false, "private_status": 0, "review_result": { "review_status": 102 }, "reviewed": 0, "self_see": false, "violation_display_status": 0 }, "video_control": { "allow_download": false, "allow_duet": false, "allow_dynamic_wallpaper": false, "allow_music": false, "allow_react": false, "allow_stitch": false, "draft_progress_bar": 0, "prevent_download_type": 0, "share_type": 0, "show_progress_bar": 0, "timer_status": 0 }, "cha_list": [ { "cid": "18881", "cha_name": "rolex", "url": "https://www.tiktok.com/tag/rolex", "is_commerce": false }, { "cid": "7029280493263585285", "cha_name": "perpetualplanet", "url": "https://www.tiktok.com/tag/perpetualplanet", "is_commerce": false } ], "text_extra": [ { "end": 19, "hashtag_id": "", "hashtag_name": "", "is_commerce": false, "sec_uid": "MS4wLjABAAAAC-8aDAW20w1Nnhh64s-kBh8ryXOkdAp9xW0yBVY002RFH7g7Dm2YNqUD1Q8Pz9IZ", "start": 13, "tag_id": null, "type": 0, "user_id": "6901691802736608258", "user_unique_id": "rolex", "sub_type": 0, "aweme_id": null }, "..." ], "share_url": "https://www.tiktok.com/@natgeo/video/7683891628230315295", "url": "https://www.tiktok.com/@natgeo/video/7683891628230315295", "image_post_info": null, "location_created": "GB", "served_region": "BD", "...": "188 top-level keys in total: every key of TikTok's native mobile aweme_detail (aweme_acl, commerce_info, interact_permission, risk_infos, share_info, suggest_words, ...) plus the web-only extras (hashtags, mentions, author_stats, diversification_labels, effect_stickers, poi, ...)" }, "transcript": "Welcome to Africa. Welcome to Earth's wild home. See a new side to animals you know and meet some you've never seen before. This is the definitive look at the wildest continent on our planet. There's no place like Africa.", "transcript_info": { "language": "eng-US", "language_code": "en", "is_auto_generated": true, "format": "webvtt", "source": "claInfo", "duration": 66.92, "segment_count": 11, "available_languages": [ "eng-US" ], "url": "https://v16-webapp.tiktok.com/709bbbc7b5ba5d10b7dceb0580a06776/6ab10164/video/tos/alisg/tos-alisg-v-37c799-sg/...", "segments": [ { "start": 3.22, "end": 4.32, "text": "Welcome" }, { "start": 6.06, "end": 7.6, "text": "to Africa." }, "..." ] }, "download_media_urls": [ { "post_id": "7683891628230315295", "type": "video", "cdn_url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIPvOIB5EwQMr2KB2AREqiVplFilPamEXoq...", "url_list": [ "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIPvOIB5EwQMr2KB2AREqiVplFilPamEXoq...", "..." ], "file_name": "7683891628230315295.mp4", "has_watermark": false, "width": 576, "height": 1024, "data_size": 13301315, "expires_at": "2026-09-21T10:05:24.000Z", "requires_cookie": true, "fetch_headers": { "referer": "https://www.tiktok.com/", "cookie": "tt_chain_token=gQ8nEEY7bw2Rio2StCFgEw==" }, "bit_rate": 1465326, "gear_name": "normal_540_0", "codec_type": "h264", "duration_seconds": 72 } ], "source": { "platform": "tiktok", "layer": "web:webapp", "fingerprint": "chrome131", "url": "https://www.tiktok.com/@natgeo/video/7683891628230315295", "app_region": "BD" }, "warnings": [ "app-only fields TikTok's web layer does not expose, left as schema defaults: suggest_words, visual_search_info, smart_search_info, music.matched_song" ], "duration_ms": 1164, "scraped_at": "2026-09-19T10:04:14.671Z" }, "next_cursor": null }}Bad input. The exact message varies by endpoint.
{ "success": false, "error": "…"}Balance below the endpoint’s price.
{ "error": "Insufficient credits. Buy more to scrape more.", "balance": 1, "required": 2}Invalid or unknown API key.
{ "detail": "Authentication service unavailable or invalid API key."}Throttled — wait for Retry-After.
{ "detail": "Request was throttled. Expected available in N seconds."}Sample from the live catalog; arrays trimmed to 3 items. Results are in data.video.
Response fields
Section titled “Response fields”| Field | Type | Example | Description |
|---|---|---|---|
urls | string | https://www.tiktok.com/@natgeo/video/76838916… | — |
video | object | {…} | The results. |
next_cursor | null | null | Pass back as cursor for the next page. null on the last page. |
video.input_url | string | https://www.tiktok.com/@natgeo/video/76838916… | — |
video.video_id | string | 7683891628230315295 | — |
video.url | string | https://www.tiktok.com/@natgeo/video/76838916… | — |
video.resolved_url | null | null | — |
video.status | string | ok | — |
video.success | boolean | true | — |
video.reason | null | null | — |
video.status_code | integer | 0 | — |
video.error | null | null | — |
video.aweme_detail | object | {…} | — |
video.transcript | string | Welcome to Africa. Welcome to Earth's wild ho… | — |
video.transcript_info | object | {…} | — |
video.download_media_urls | array | [1 item] | — |
video.source | object | {…} | — |
video.warnings | array | [1 item] | — |
video.duration_ms | integer | 1164 | — |
video.scraped_at | string | 2026-09-19T10:04:14.671Z | — |
Pagination
Section titled “Pagination”Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.
const url = "https://api.scrapier.io/api/v2/tiktok-single-video-info/";let params = { urls: "https://www.tiktok.com/@scout2015/video/6718335390845095173" };const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call const res = await fetch(`${url}?${new URLSearchParams(params)}`, { headers: { "X-API-Key": "YOUR_API_KEY" }, signal: AbortSignal.timeout(210_000), }); const body = await res.json(); if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`); const data = body.data; items.push(data.video); if (!data.next_cursor) break; // null = last page params = { cursor: data.next_cursor };}import requests
URL = "https://api.scrapier.io/api/v2/tiktok-single-video-info/"HEADERS = {"X-API-Key": "YOUR_API_KEY"}params = {"urls": "https://www.tiktok.com/@scout2015/video/6718335390845095173"}items = []
for _ in range(10): # each page is one billed call resp = requests.get(URL, headers=HEADERS, params=params, timeout=210) resp.raise_for_status() data = resp.json()["data"] items.append(data.get("video")) if not data.get("next_cursor"): # None = last page break params = {"cursor": data["next_cursor"]}Errors
Section titled “Errors”Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.
| Status | Meaning | Retry? | Charged? |
|---|---|---|---|
400 | Bad or missing input. | No — fix the params | No |
401 / 403 | Missing, invalid or revoked API key. | No — fix the key | No |
402 | Out of credits (body has balance). | No — top up | No |
404 | Unknown endpoint slug. | No — check the slug | No |
429 / 503 | Busy or throttled. | Yes — after Retry-After | No |
5xx | Target site or upstream failure, or timeout. | Yes — with backoff | No |
- The response data carries its own
successfield from the scraper. The outersuccessis what counts: an HTTP 200 with outersuccess: trueis billed, even if the inner field says otherwise.
Related
Section titled “Related”- TikTok Ad Library Leads — Structured TikTok data: every input is optional. Single lookup, 3 credits per successful call.
- TikTok Ad Library — Structured TikTok data: send
urls. Cursor-paginated, 1 credit per successful call. - TikTok Ads Top — Structured TikTok data: every input is optional. Cursor-paginated, 1 credit per successful call.
- TikTok Collection Videos — Structured TikTok data: send
urls. Cursor-paginated, 1 credit per successful call.