Meta tags:
description=Supadata Node SDK is a wrapper around the Supadata API to help you easily turn videos into transcripts and websites into markdown.;

Headings (most frequently used words):

node, documentation, index, on, this, page, installation, usage, general, sdks, integrations, transcripts, youtube, web, error, handling,

Text of the page (most frequently used words):
supadata (39), youtube (32), #transcript (23), const (20), await (18), console (14), get (14), error (13), job (13), video (12), node (12), the (10), status (10), batch (10), web (9), for (9), from (9), jobid (9), https (9), url (9), log (9), playlist (9), channel (8), optional (7), can (7), crawl (7), dqw4w9wgxcq (7), jobresult (7), documentation (6), transcriptresult (6), and (5), transcripts (5), page (5), sdk (5), batchresults (5), metadata (5), com (5), this (4), platform (4), api (4), results (4), map (4), scrape (4), else (4), completed (4), alternatively (4), videoids (4), lang (4), auto (4), text (4), file (4), use (4), supadataerror (3), import (3), you (3), handle (3), handling (3), limit (3), content (3), videobatch (3), transcriptbatch (3), poll (3), failed (3), started (3), pllan88a7y2_plecyojxvrftlhvbivaooc (3), www (3), list (3), videos (3), all (3), any (3), supported (3), tiktok (3), instagram (3), twitter (3), sdks (3), integrations (3), mcp (2), server (2), scraping (2), agents (2), python (2), message (2), catch (2), videoid (2), errors (2), crawljob (2), website (2), stats (2), channelid (2), uc_9 (2), kytw8zkzndhqj6fgpwq (2), playlistid (2), xvfzjo5pgg0 (2), start (2), ids (2), youtubeplaylist (2), rickastleyvevo (2), youtubechannel (2), youtubevideo (2), translate (2), native (2), generate (2), mode (2), return (2), plain (2), instead (2), timestamped (2), chunks (2), true (2), watch (2), your_api_key (2), apikey (2), new (2), initialize (2), client (2), files (2), directly (2), active (2), with (2), usage (2), install (2), npm (2), installation (2), copy (2), into (2), search (2), dashboard (2), docs (2), index (2), built, hosted, mintlify, developer, powered, github, raise, issue, suggest, edits, yes, was, helpful, link, documentationurl, detailed, description, details, human, readable, not, found, instanceof, invalid_id, try, throws, related, these, follows, getcrawlresults, crawlresults, sitemap, urls, webcontent, getbatchresults, until, l_jwhffix5e, playlistvideos, plfgqulnl59alcl_2tqvoid5vgm1hcagsi, short, live, type, channelvideos, translated, youtu, smaller, queued, getjobstatus, large, need, check, got, async, processing, transcriptorjobid, here, example, how, key, then, dash, pnpm, yarn, bun, etc, wrapper, around, help, easily, turn, websites, markdown, pieces, make, zapier, n8n, overview, general, changelog, feedback, playground, reference, navigation, support, home, skip, main, discover, available, pages, before, exploring, further, fetch, complete, llms, txt,

Text of the page (random words):
node supadata docs documentation index fetch the complete documentation index at llms txt use this file to discover all available pages before exploring further skip to main content supadata docs home page search k status support dashboard dashboard search navigation sdks node documentation integrations api reference playground feedback changelog general integrations overview sdks python node integrations supadata mcp server youtube transcripts web scraping for ai agents n8n zapier make active pieces on this page installation usage transcripts youtube web error handling sdks node copy page supadata node sdk is a wrapper around the supadata api to help you easily turn videos into transcripts and websites into markdown copy page installation to install the supadata node sdk you can use npm or pnpm yarn bun etc node npm install supadata js usage get an api key from dash supadata ai then use it with the sdk here s an example of how to use the sdk with error handling node import crawl crawljob jobresult map scrape supadata transcript transcriptorjobid youtubechannel youtubeplaylist youtubevideo from supadata js initialize the client const supadata new supadata apikey your_api_key get transcript from any supported platform youtube tiktok instagram x twitter or file const transcriptresult await supadata transcript url https www youtube com watch v dqw4w9wgxcq lang en optional text true optional return plain text instead of timestamped chunks mode auto optional native auto or generate check if we got a transcript directly or a job id for async processing if jobid in transcriptresult for large files we get a job id and need to poll for results console log started transcript job transcriptresult jobid poll for job status const jobresult await supadata transcript getjobstatus transcriptresult jobid if jobresult status completed console log transcript jobresult content else if jobresult status failed console error transcript failed jobresult error else console log job status jobresult status queued or active else for smaller files we get the transcript directly console log transcript transcriptresult transcripts get transcript from any supported platform youtube tiktok instagram x twitter or file node import supadata from supadata js initialize the client const supadata new supadata apikey your_api_key get transcript from any supported platform youtube tiktok instagram x twitter or file const transcriptresult await supadata transcript url https www youtube com watch v dqw4w9wgxcq lang en optional text true optional return plain text instead of timestamped chunks mode auto optional native auto or generate youtube get youtube video channel playlist metadata node const transcript transcript await supadata youtube transcript url https youtu be dqw4w9wgxcq translate youtube transcript const translated transcript await supadata youtube translate videoid dqw4w9wgxcq lang es get a youtube video metadata const video youtubevideo await supadata youtube video id dqw4w9wgxcq can be url or video id get a youtube channel metadata const channel youtubechannel await supadata youtube channel id https youtube com rickastleyvevo can be url channel id handle get a list of video ids from a youtube channel const channelvideos videoids await supadata youtube channel videos id https youtube com rickastleyvevo can be url channel id handle type all video short live all limit 10 get the metadata of a youtube playlist const playlist youtubeplaylist await supadata youtube playlist id plfgqulnl59alcl_2tqvoid5vgm1hcagsi can be url or playlist id get a list of video ids from a youtube playlist const playlistvideos videoids await supadata youtube playlist videos id https www youtube com playlist list pllan88a7y2_plecyojxvrftlhvbivaooc can be url or playlist id limit 10 start a youtube transcript batch job const transcriptbatch await supadata youtube transcript batch videoids dqw4w9wgxcq xvfzjo5pgg0 playlistid pllan88a7y2_plecyojxvrftlhvbivaooc alternatively channelid uc_9 kytw8zkzndhqj6fgpwq alternatively lang en console log started transcript batch job transcriptbatch jobid start a youtube video metadata batch job const videobatch await supadata youtube video batch videoids dqw4w9wgxcq xvfzjo5pgg0 l_jwhffix5e playlistid pllan88a7y2_plecyojxvrftlhvbivaooc alternatively channelid uc_9 kytw8zkzndhqj6fgpwq alternatively console log started video batch job videobatch jobid get results for a batch job poll until status is completed or failed const batchresults await supadata youtube batch getbatchresults transcriptbatch jobid or videobatch jobid if batchresults status completed console log batch job completed batchresults results console log stats batchresults stats else console log batch job status batchresults status web scrape and crawl web content node const webcontent scrape await supadata web scrape https supadata ai map website urls const sitemap map await supadata web map https supadata ai crawl website const crawl jobid await supadata web crawl url https supadata ai limit 10 get crawl job results const crawlresults crawljob await supadata web getcrawlresults crawl jobid error handling the sdk throws supadataerror for api related errors you can catch and handle these errors as follows node import supadataerror from supadata js try const transcript await supadata youtube transcript videoid invalid_id catch e if e instanceof supadataerror console error e error e g video not found console error e message human readable error message console error e details detailed error description console error e documentationurl link to error documentation optional was this page helpful yes no suggest edits raise issue python supadata mcp server youtube transcripts web scraping for ai agents i github powered by this documentation is built and hosted on mintlify a developer documentation platform