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

supadata_metadata_get 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. 1 param

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.

Name Type Required Description
url string required URL of the video or media to retrieve metadata for.
supadata_transcript_get 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. 5 params

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.

Name Type Required Description
url string required URL of the video or media file to transcribe. Supports YouTube, TikTok, Instagram, X, Facebook, or direct video/audio file URLs.
chunkSize integer optional Maximum number of characters per transcript segment chunk.
lang string optional ISO 639-1 language code for the transcript (e.g., en, fr, de). Defaults to the video's original language.
mode string optional Transcript generation mode: native (use existing captions, 1 credit), auto (native with AI fallback), or generate (AI-generated, 2 credits/minute).
text boolean optional Return plain text instead of timestamped segments. Defaults to false.
supadata_web_map 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. 1 param

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.

Name Type Required Description
url string required Base URL of the website to map.
supadata_web_scrape 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. 3 params

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.

Name Type Required Description
url string required URL of the web page to scrape.
lang string optional ISO 639-1 language code to request content in a specific language (e.g., en, fr, de).
noLinks boolean optional Strip all hyperlinks from the Markdown output. Defaults to false.
supadata_youtube_channel_get Retrieve metadata for a YouTube channel including name, description, subscriber count, video count, and thumbnails. 1 param

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

Name Type Required Description
channelId string required YouTube channel ID, handle (@username), or full channel URL.
supadata_youtube_playlist_get Retrieve metadata and video list for a YouTube playlist including title, description, video count, and individual video details. 1 param

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

Name Type Required Description
playlistId string required YouTube playlist ID or full playlist URL.
supadata_youtube_transcript_get Retrieve the transcript for a YouTube video by video ID or URL. Returns timestamped segments with text content. 3 params

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

Name Type Required Description
videoId string required YouTube video ID or full YouTube URL to retrieve the transcript for.
lang string optional ISO 639-1 language code for the transcript (e.g., en, fr, de).
text boolean optional Return plain text instead of timestamped segments. Defaults to false.
supadata_youtube_transcript_translate Retrieve and translate a YouTube video transcript into a target language. Returns translated timestamped segments. 3 params

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

Name Type Required Description
lang string required ISO 639-1 language code to translate the transcript into (e.g., en, fr, es).
videoId string required YouTube video ID or full YouTube URL to translate the transcript for.
text boolean optional Return plain text instead of timestamped segments. Defaults to false.
supadata_youtube_video_get Retrieve detailed metadata for a YouTube video including title, description, view count, like count, duration, tags, thumbnails, and channel info. 1 param

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

Name Type Required Description
videoId string required YouTube video ID or full YouTube URL.