Skip to content

Structured TikTok data: send urls. Single lookup, 1 credit per successful call.

GET Β· POST1 credit / successful callSingle lookupLong-running
GEThttps://api.scrapier.io/api/v2/tiktok-transcript/Open in Playground

Call GET /api/v2/tiktok-transcript/ with urls. The results are in data.transcript. 9 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/tiktok-transcript/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "urls=https://www.tiktok.com/@natgeo/video/7683891628230315295" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyesβ€”Your API key from the dashboard.
urlsstringyese.g. https://www.tiktok.com/@natgeo/video/7683891628230315295TikTok 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 (transcript text + VTT + segments, every caption track inline, moments, post metadata) is returned under transcript, next_cursor is always null.
cursorstringnoβ€”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.
languagestringnoen2-letter code of the transcript wanted; falls back to the original-language track. en on a non-English video without captions is translated by Whisper.
locked in cursor
use_ai_as_fallbackbooleannotruefaster-whisper transcription for videos WITHOUT caption tracks.
locked in cursor
ai_max_duration_secondsintegerno60Longest video the AI fallback transcribes on default 60, hard cap 90. Longer videos without captions return transcript null + transcript_reason.
locked in cursor
transcribe_allbooleannofalseAI-transcribe even when captions exist (captions still returned).
locked in cursor
momentsstringnotruetrue/all, false, or a CSV of moment kinds located on the transcript timeline.
truefalsebrandsponsor_readproduct_democall_to_action
locked in cursor
brandstringnoβ€”Brand / product name for the brand moment kind.
locked in cursor
whisper_modelstringnobasefaster-whisper size for the AI path (base pre-warmed).
tinybasesmall
locked in cursor
whisper_devicestringnocpuInference device for faster-whisper.
cpuautocuda
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen 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.
{
"success": true,
"data": {
"urls": "https://www.tiktok.com/@natgeo/video/7683891628230315295",
"transcript": {
"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,
"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_source": "captions",
"transcript_reason": "tiktok caption track",
"transcript_vtt": "WEBVTT\n\n\n00:00:03.220 --> 00:00:04.320\nWelcome\n\n00:00:06.060 --> 00:00:07.600\nto Africa.\n\n00:00:08.300 --> 00:00:09.400\n...",
"language": "eng-US",
"language_code": "en",
"language_requested": "en",
"language_matched": true,
"transcript_info": {
"source": "captions",
"language": "eng-US",
"language_code": "en",
"language_requested": "en",
"language_matched": true,
"is_auto_generated": true,
"is_original_language": true,
"variant": "big_caption",
"provider": "tiktok",
"model": null,
"translated_from": null,
"duration_seconds": 66.92,
"segment_count": 11,
"word_count": 40,
"available_languages": [
"eng-US"
],
"reason": "tiktok caption track",
"moments_requested": [
"brand",
"sponsor_read",
"product_demo"
]
},
"segments": [
{
"start": 3.22,
"end": 4.32,
"text": "Welcome"
},
{
"start": 6.06,
"end": 7.6,
"text": "to Africa."
},
{
"start": 8.3,
"end": 9.4,
"text": "Welcome"
}
],
"caption_tracks": [
{
"language": "eng-US",
"language_code": "en",
"is_original": true,
"is_auto_generated": true,
"source": "ASR",
"source_unabbreviated": "automatic speech recognition",
"version": "1:big_caption",
"variant": "big_caption",
"format": "webvtt",
"size_bytes": 571,
"expires_at": "2026-09-22T10:01:09.000Z",
"url": "https://v16-webapp.tiktok.com/9baa969fd53f6e963fbc38b0153039d9/6ab251e5/video/tos/alisg/to...",
"url_list": [
"https://v16-webapp.tiktok.com/9baa969fd53f6e963fbc38b0153039d9/6ab251e5/video/tos/alisg/to...",
"https://v16-webapp.tiktok.com/9baa969fd53f6e963fbc38b0153039d9/6ab251e5/video/tos/alisg/to...",
"https://www.tiktok.com/aweme/v1/play/?faid=1988&format=webvtt&is_play_url=1&language=eng-U..."
],
"downloaded": true,
"text": "Welcome to Africa. Welcome to Earth's wild home. See a new side to animals you know and meet some yo...",
"segments": [
{
"start": 3.22,
"end": 4.32,
"text": "Welcome"
},
{
"start": 6.06,
"end": 7.6,
"text": "to Africa."
},
"... 9 more segments"
],
"segment_count": 11,
"word_count": 40,
"duration_seconds": 66.92,
"error": null
}
],
"available_languages": [
"eng-US"
],
"moments": [],
"brand": "Rolex",
"id": "7683891628230315295",
"text": "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.",
"text_language": "en",
"create_time": 1789045447,
"create_time_iso": "2026-09-10T13:04:07.000Z",
"location_created": "GB",
"is_ad": false,
"has_tik_tok_shop_product": false,
"author_meta": {
"id": "6780344874811442181",
"name": "natgeo",
"profile_url": "https://www.tiktok.com/@natgeo",
"nick_name": "National Geographic",
"verified": true,
"signature": "Step into wonder and find your inner explorer with National Geographic 🌎",
"bio_link": null,
"avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/324924e171e481040a1ea202962f6e07...",
"commerce_user_info": {
"commerce_user": false
},
"private_account": false,
"room_id": "",
"tt_seller": false,
"create_time": 1578672517,
"has_active_story": false,
"following": 62,
"friends": 0,
"fans": 9600000,
"heart": 54600000,
"video": 1506,
"digg": 3142,
"original_avatar_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/324924e171e481040a1ea202962f6e07...",
"sec_uid": "MS4wLjABAAAAEf96k3JW8-3eOhgzgQswlFF6ZDnn1dzqWWorJjwDsiNZymqTtvOcFhp_RiYYST6s",
"avatar_thumb": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/324924e171e481040a1ea202962f6e07...",
"is_embed_banned": false,
"is_ad_virtual": false
},
"music_meta": {
"music_name": "original sound",
"music_author": "National Geographic",
"music_original": true,
"play_url": "https://v16m.tiktokcdn.com/11e3cea617be6b8c284c0917057662f6/6ab10065/video/tos/alisg/tos-a...",
"cover_medium_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/324924e171e481040a1ea202962f6e07...",
"original_cover_medium_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/324924e171e481040a1ea202962f6e07...",
"music_id": "7683891712992774942",
"music_album": null,
"duration": 72,
"precise_duration": 72.673,
"is_copyrighted": false,
"is_commerce_music": false
},
"location_meta": null,
"web_video_url": "https://www.tiktok.com/@natgeo/video/7683891628230315295",
"video_meta": {
"height": 1024,
"width": 576,
"duration": 72,
"cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oMAACXiIEiA1iUUfjqiKiECG7sV2q...",
"definition": "540p",
"format": "mp4",
"ai_video_description": null,
"ai_video_summary": null,
"original_cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ocLRlIqwP6EqABiqiPBIpimKAEBaB...",
"dynamic_cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oMAACXiIEiA1iUUfjqiKiECG7sV2q...",
"video_id": "v15044gf0000dahag47og65gkpkkv5bg",
"bitrate": 1465326,
"codec_type": "h264",
"video_quality": "normal",
"size_bytes": 13301315,
"has_original_audio": true,
"auto_caption_enabled": true,
"no_caption_reason": null,
"no_caption_reason_text": null,
"original_language": "eng-US",
"play_addr": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIPvOIB5EwQMr2K...",
"play_urls": [
{
"gear": "normal_540_0",
"bitrate": 1465326,
"codec": "h264",
"quality": 20,
"width": 576,
"height": 1024,
"size_bytes": 13301315,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIPvOIB5EwQMr2K..."
},
"... 2 more renditions"
]
},
"digg_count": 17700,
"share_count": 536,
"play_count": 124200,
"collect_count": 1027,
"comment_count": 291,
"repost_count": 0,
"mentions": [
"@rolex",
"@disneyplus",
"@hulu"
],
"detailed_mentions": [
{
"id": "6901691802736608258",
"name": "rolex",
"sec_uid": "MS4wLjABAAAAC-8aDAW20w1Nnhh64s-kBh8ryXOkdAp9xW0yBVY002RFH7g7Dm2YNqUD1Q8Pz9IZ",
"profile_url": "https://www.tiktok.com/@rolex"
},
{
"id": "6844178288162063365",
"name": "disneyplus",
"sec_uid": "MS4wLjABAAAAqUNM3kSR5Ftp2-qS8tMXPcOX8sQIrztPZ6xbXF19zZMi805WqA158zLCL15WnGHL",
"profile_url": "https://www.tiktok.com/@disneyplus"
},
{
"id": "6647632235926503429",
"name": "hulu",
"sec_uid": "MS4wLjABAAAAM4MY_0Mngt5neJyXf3HiDcYRyCBv_dMx1DU4OpbQNbNThk2QRZLWPKgSidSUqAd8",
"profile_url": "https://www.tiktok.com/@hulu"
}
],
"hashtags": [
{
"id": "18881",
"name": "rolex",
"title": null,
"cover": null
},
{
"id": "7029280493263585285",
"name": "perpetualplanet",
"title": null,
"cover": null
}
],
"effect_stickers": [],
"is_slideshow": false,
"is_pinned": false,
"is_sponsored": false,
"short_drama_series_info": null,
"media_urls": [],
"is_story": false,
"submitted_video_url": "https://www.tiktok.com/@natgeo/video/7683891628230315295",
"text_on_screen": [],
"diversification_labels": [
"Animals",
"Nature"
],
"is_aigc": false,
"branded_content": false,
"duet_enabled": null,
"stitch_enabled": null,
"share_enabled": true,
"comments_enabled": true,
"source": {
"platform": "tiktok",
"layer": "web:webapp",
"fingerprint": "firefox135",
"url": "https://www.tiktok.com/@natgeo/video/7683891628230315295",
"app_region": "BD"
},
"warnings": [],
"fetch_stats": {
"requests": 2,
"retries": 0,
"waf_solved": 0,
"akamai_denied": 0,
"bytes_downloaded": 0,
"ai_seconds": 0
},
"duration_ms": 634,
"scraped_at": "2026-09-20T10:00:01.065Z"
},
"next_cursor": null
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.transcript.

FieldTypeExampleDescription
urlsstringhttps://www.tiktok.com/@natgeo/video/76838916…—
transcriptobject{…}The results.
next_cursornullnullPass back as cursor for the next page. null on the last page.
transcript.input_urlstringhttps://www.tiktok.com/@natgeo/video/76838916…—
transcript.video_idstring7683891628230315295β€”
transcript.urlstringhttps://www.tiktok.com/@natgeo/video/76838916…—
transcript.resolved_urlnullnullβ€”
transcript.statusstringokβ€”
transcript.successbooleantrueβ€”
transcript.reasonnullnullβ€”
transcript.status_codeinteger0β€”
transcript.errornullnullβ€”
transcript.transcriptstringWelcome to Africa. Welcome to Earth's wild ho…—
transcript.transcript_sourcestringcaptionsβ€”
transcript.transcript_reasonstringtiktok caption trackβ€”
transcript.transcript_vttstringWEBVTT 00:00:03.220 --> 00:00:04.320 Welcom…—
transcript.languagestringeng-USβ€”
transcript.language_codestringenβ€”
transcript.language_requestedstringenβ€”
transcript.language_matchedbooleantrueβ€”
transcript.transcript_infoobject{…}β€”
transcript.segmentsarray[4 items]β€”
transcript.caption_tracksarray[1 item]β€”
transcript.available_languagesarray[1 item]β€”
transcript.momentsarray[]β€”
transcript.brandstringRolexβ€”
transcript.idstring7683891628230315295β€”
transcript.textstringPresented by @ROLEX. Welcome to Africa 🌍 Afr…—
transcript.text_languagestringenβ€”
transcript.create_timeinteger1789045447β€”
transcript.create_time_isostring2026-09-10T13:04:07.000Zβ€”
transcript.location_createdstringGBβ€”
transcript.is_adbooleanfalseβ€”
transcript.has_tik_tok_shop_productbooleanfalseβ€”
transcript.author_metaobject{…}β€”
transcript.music_metaobject{…}β€”
transcript.location_metanullnullβ€”
transcript.web_video_urlstringhttps://www.tiktok.com/@natgeo/video/76838916…—
transcript.video_metaobject{…}β€”
transcript.digg_countinteger17700β€”
transcript.share_countinteger536β€”
transcript.play_countinteger124200β€”
transcript.collect_countinteger1027β€”
transcript.comment_countinteger291β€”
transcript.repost_countinteger0β€”
transcript.mentionsarray[3 items]β€”
transcript.detailed_mentionsarray[3 items]β€”
transcript.hashtagsarray[2 items]β€”
transcript.effect_stickersarray[]β€”
transcript.is_slideshowbooleanfalseβ€”
transcript.is_pinnedbooleanfalseβ€”
transcript.is_sponsoredbooleanfalseβ€”
transcript.short_drama_series_infonullnullβ€”
transcript.media_urlsarray[]β€”
transcript.is_storybooleanfalseβ€”
transcript.submitted_video_urlstringhttps://www.tiktok.com/@natgeo/video/76838916…—
transcript.text_on_screenarray[]β€”
transcript.diversification_labelsarray[2 items]β€”
transcript.is_aigcbooleanfalseβ€”
transcript.branded_contentbooleanfalseβ€”
transcript.duet_enablednullnullβ€”
transcript.stitch_enablednullnullβ€”
transcript.share_enabledbooleantrueβ€”
transcript.comments_enabledbooleantrueβ€”
transcript.sourceobject{…}β€”
transcript.warningsarray[]β€”
transcript.fetch_statsobject{…}β€”
transcript.duration_msinteger634β€”
transcript.scraped_atstring2026-09-20T10:00:01.065Zβ€”

Returns everything in one call; next_cursor is always null.

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No β€” fix the paramsNo
401 / 403Missing, invalid or revoked API key.No β€” fix the keyNo
402Out of credits (body has balance).No β€” top upNo
404Unknown endpoint slug.No β€” check the slugNo
429 / 503Busy or throttled.Yes β€” after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes β€” with backoffNo
  • The response data carries its own success field from the scraper. The outer success is what counts: an HTTP 200 with outer success: true is billed, even if the inner field says otherwise.
  • This endpoint can take several minutes. Set your client timeout to at least 210 seconds.
  • 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.