Skip to content
Talk to an Engineer Dashboard

Supadata

Connect with Supadata to extract transcripts, metadata, and structured content from YouTube, social media, and the web using AI.

Connect with Supadata to extract transcripts, metadata, and structured content from YouTube, social media, and the web using AI.

Supadata logo

Supports authentication: API Key

Retrieve unified metadata for a video or media URL including title, description, author info, engagement stats, media details, and creation date. Supports YouTube, TikTok, Instagram, X (Twitter), Facebook, and more.

NameTypeRequiredDescription
urlstringYesURL of the video or media to retrieve metadata for.

Extract transcripts from YouTube, TikTok, Instagram, X (Twitter), Facebook, or direct file URLs. Supports native captions, auto-generated captions, or AI-generated transcripts. Returns timestamped segments with speaker labels.

NameTypeRequiredDescription
chunkSizeintegerNoMaximum number of characters per transcript segment chunk.
langstringNoISO 639-1 language code for the transcript (e.g., en, fr, de). Defaults to the video’s original language.
modestringNoTranscript generation mode: native (use existing captions, 1 credit), auto (native with AI fallback), or generate (AI-generated, 2 credits/minute).
textbooleanNoReturn plain text instead of timestamped segments. Defaults to false.
urlstringYesURL of the video or media file to transcribe. Supports YouTube, TikTok, Instagram, X, Facebook, or direct video/audio file URLs.

Discover and return all URLs found on a website. Useful for site structure analysis, link auditing, and building crawl lists. Costs 1 credit per request.

NameTypeRequiredDescription
urlstringYesBase URL of the website to map.

Scrape a web page and return its content as clean Markdown. Ideal for extracting readable content from any URL while stripping away navigation and ads.

NameTypeRequiredDescription
langstringNoISO 639-1 language code to request content in a specific language (e.g., en, fr, de).
noLinksbooleanNoStrip all hyperlinks from the Markdown output. Defaults to false.
urlstringYesURL of the web page to scrape.

Retrieve metadata for a YouTube channel including name, description, subscriber count, video count, and thumbnails.

NameTypeRequiredDescription
channelIdstringYesYouTube channel ID, handle (@username), or full channel URL.

Retrieve metadata and video list for a YouTube playlist including title, description, video count, and individual video details.

NameTypeRequiredDescription
playlistIdstringYesYouTube playlist ID or full playlist URL.

Search YouTube for videos, channels, or playlists. Returns results with titles, IDs, descriptions, thumbnails, and metadata.

NameTypeRequiredDescription
langstringNoISO 639-1 language code to filter results by language (e.g., en, fr).
limitintegerNoMaximum number of results to return.
querystringYesSearch query string to find videos, channels, or playlists on YouTube.
typestringNoType of results to return: video, channel, or playlist.

Retrieve the transcript for a YouTube video by video ID or URL. Returns timestamped segments with text content.

NameTypeRequiredDescription
langstringNoISO 639-1 language code for the transcript (e.g., en, fr, de).
textbooleanNoReturn plain text instead of timestamped segments. Defaults to false.
videoIdstringYesYouTube video ID or full YouTube URL to retrieve the transcript for.

Retrieve and translate a YouTube video transcript into a target language. Returns translated timestamped segments.

NameTypeRequiredDescription
langstringYesISO 639-1 language code to translate the transcript into (e.g., en, fr, es).
textbooleanNoReturn plain text instead of timestamped segments. Defaults to false.
videoIdstringYesYouTube video ID or full YouTube URL to translate the transcript for.

Retrieve detailed metadata for a YouTube video including title, description, view count, like count, duration, tags, thumbnails, and channel info.

NameTypeRequiredDescription
videoIdstringYesYouTube video ID or full YouTube URL.