Supadata

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

Supports authentication: API Key

Tool list

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.

Name	Type	Required	Description
url	string	Yes	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.

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

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.

Name	Type	Required	Description
url	string	Yes	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.

Name	Type	Required	Description
lang	string	No	ISO 639-1 language code to request content in a specific language (e.g., en, fr, de).
noLinks	boolean	No	Strip all hyperlinks from the Markdown output. Defaults to false.
url	string	Yes	URL of the web page to scrape.

supadata_youtube_channel_get

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

Name	Type	Required	Description
channelId	string	Yes	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.

Name	Type	Required	Description
playlistId	string	Yes	YouTube playlist ID or full playlist URL.

supadata_youtube_search

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

Name	Type	Required	Description
lang	string	No	ISO 639-1 language code to filter results by language (e.g., en, fr).
limit	integer	No	Maximum number of results to return.
query	string	Yes	Search query string to find videos, channels, or playlists on YouTube.
type	string	No	Type of results to return: video, channel, or playlist.

supadata_youtube_transcript_get

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

Name	Type	Required	Description
lang	string	No	ISO 639-1 language code for the transcript (e.g., en, fr, de).
text	boolean	No	Return plain text instead of timestamped segments. Defaults to false.
videoId	string	Yes	YouTube video ID or full YouTube URL to retrieve the transcript for.

supadata_youtube_transcript_translate

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

Name	Type	Required	Description
lang	string	Yes	ISO 639-1 language code to translate the transcript into (e.g., en, fr, es).
text	boolean	No	Return plain text instead of timestamped segments. Defaults to false.
videoId	string	Yes	YouTube video ID or full YouTube URL to translate the transcript for.

supadata_youtube_video_get

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	Yes	YouTube video ID or full YouTube URL.