# Supadata — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_supadata?ms=1787295720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `supadata_get_me`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/supadata`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/supadata/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/supadata/get/transcript` — 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
  - body: { url: string, lang?: string, mode?: string, text?: boolean, chunkSize?: integer }
- `POST https://api.mcp.ai/api/supadata/get/transcript/by/job/id` — 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.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/supadata/get/web/map` — 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
  - body: { url: string, lang?: string }
- `POST https://api.mcp.ai/api/supadata/get/web/scrape` — 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 -
  - body: { url: string, lang?: string, no_links?: boolean }
- `POST https://api.mcp.ai/api/supadata/get/youtube/channel` — 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.
  - body: { id: string }
- `POST https://api.mcp.ai/api/supadata/get/youtube/channel/videos` — 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
  - body: { type?: string, limit?: integer, channel_id: string }
- `POST https://api.mcp.ai/api/supadata/get/youtube/playlist` — 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 
  - body: { id: string }
- `POST https://api.mcp.ai/api/supadata/get/youtube/playlist/videos` — 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.
  - body: { limit?: integer, playlistId: string }
- `POST https://api.mcp.ai/api/supadata/get/youtube/video` — 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
  - body: { video_id: string }
- `POST https://api.mcp.ai/api/supadata/search/youtube` — Search YouTube for videos, channels, or playlists by keyword. Returns matching content with metadata like titles, thumbnails, view counts, and channel information.
  - body: { type?: string, limit?: integer, query: string }

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

## More
- Page: https://mcp.ai/supadata
- Agent spec (llms.txt): https://mcp.ai/supadata/llms.txt
- Postman collection: https://mcp.ai/supadata/postman.json