# Supadata — MCP server on mcp.ai
> Connect your Supadata account and use 11 tools for web scraping straight from your AI agent. Connect with your own API key. Supadata is a web and video-to-text API that extracts transcripts from YouTube, TikTok, Instagram, Facebook, X (Twitter) and video files, retrieves social media metadata, and converts web content to markdown for AI training and content analysis.

By: mcp.ai · official
Page: https://mcp.ai/supadata

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_supadata?ms=1787295900000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/supadata/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/supadata/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/supadata/skill.md
Postman collection (v2.1): https://mcp.ai/supadata/postman.json

## Tools
- supadata_get_me() — Retrieve organization details, plan information, and credit usage for the authenticated account. Use this to check account status, credit balance, and subscription plan.
- supadata_get_transcript(url: string, lang?: string, mode?: string, text?: boolean, chunkSize?: integer) — Get transcript from a video on supported platforms or from a file URL. Use this tool when you need to: - Retrieve transcripts from YouTube, TikTok, Twitter, Instagram, or Facebook videos - Extract tra
- supadata_get_transcript_by_job_id(job_id: string) — Get results for a transcript job by job ID. Use this to retrieve results of asynchronous transcript processing. Check the status field to determine if the job is complete.
- supadata_get_web_map(url: string, lang?: string) — Crawl a website and extract all URLs/links found on it. Use this to create a sitemap, discover all pages of a website, or prepare for content scraping across multiple pages. Returns a list of all URLs
- supadata_get_web_scrape(url: string, lang?: string, no_links?: boolean) — Extract content from any webpage and convert it to Markdown format. Use this tool when you need to: - Read and extract text content from a web page - Get metadata (title, description) from a webpage -
- supadata_get_youtube_channel(id: string) — Fetches metadata for a YouTube channel including name, description, subscriber count, video count, view count, and channel images. Accepts channel IDs, handles, or full YouTube URLs.
- supadata_get_youtube_channel_videos(type?: string, limit?: integer, channel_id: string) — Tool to retrieve video IDs from a YouTube channel. Returns lists of regular video IDs, YouTube Shorts IDs, and live stream IDs. Videos are ordered latest first. Use this to get video IDs that can be p
- supadata_get_youtube_playlist(id: string) — Retrieve metadata for a YouTube playlist including title, description, video count, view count, last updated timestamp, and channel information. Use this when you need playlist-level information. For 
- supadata_get_youtube_playlist_videos(limit?: integer, playlistId: string) — Tool to retrieve video IDs from a YouTube playlist. Returns lists of standard video IDs, YouTube Shorts IDs, and live stream IDs contained in the playlist.
- supadata_get_youtube_video(video_id: string) — Retrieve comprehensive metadata for a YouTube video by its ID. Use this tool when you need to get details about a specific YouTube video including: - Title, description, and tags - Channel information
- supadata_search_youtube(type?: string, limit?: integer, query: string) — Search YouTube for videos, channels, or playlists by keyword. Returns matching content with metadata like titles, thumbnails, view counts, and channel information.

## Example prompts
- "What can I do in Supadata?"
- "Show me a summary of my Supadata account"

## Links
Docs: https://mcp.ai/docs/mcps/supadata
Website: https://mcp.ai/mcps/supadata