Supadata API

Use the Supadata API via direct

curl

calls to extract video transcripts and scrape web content for AI applications.

Official docs:
https://docs.supadata.ai/

When to Use

Use this skill when you need to:

Extract transcripts from YouTube, TikTok, Instagram, X (Twitter), Facebook videos
Scrape web pages to markdown format for AI processing
Get video/channel metadata from social platforms
Crawl websites to extract content from multiple pages

Prerequisites

Sign up at Supadata Dashboard
API key is automatically generated on signup (no credit card required)
Store your API key in environment variable

bash

export SUPADATA_API_KEY="your-api-key"

Pricing

Transcript fetch (existing): 1 credit
Transcript generation (AI): 2 credits/minute
Free tier available

Important: When using
$VAR
in a command that pipes to another command, wrap the command containing
$VAR
in
bash -c '...'
. Due to a Claude Code bug, environment variables are silently cleared when pipes are used directly.
bash
bash -c 'curl -s "https://api.example.com" -H "Authorization: Bearer $API_KEY"' | jq .

How to Use

All examples below assume you have

SUPADATA_API_KEY

set.

The base URL for the API is:

```
https://api.supadata.ai/v1
```

Authentication uses the

x-api-key

header.

1. Get YouTube Video Transcript

Extract transcript from a YouTube video:

Write to

/tmp/supadata_url.txt

https://www.youtube.com/watch?v=dQw4w9WgXcQ

bash

bash -c 'curl -s "https://api.supadata.ai/v1/transcript" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt" -d "text=true"'

Parameters:

```
url
```
: Video URL (required)
```
text
```
: Return plain text (
```
true
```
) or timestamped chunks (
```
false
```
, default)
```
lang
```
: Preferred language (ISO 639-1 code, e.g.,
```
en
```
,
```
zh
```
)
```
mode
```
:
```
native
```
(existing only),
```
generate
```
(AI),
```
auto
```
(default)

2. Get Transcript with Timestamps

Get transcript with timing information:

bash

bash -c 'curl -s "https://api.supadata.ai/v1/transcript" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt" -d "text=false"' | jq '.content[:3]'

Response format:

json

{
  "content": [
  {"text": "Hello", "offset": 0, "duration": 1500, "lang": "en"}
  ],
  "lang": "en",
  "availableLangs": ["en", "es", "zh"]
}

3. Get TikTok/Instagram/X Transcript

Extract transcript from other platforms:

bash

# TikTok
bash -c 'curl -s "https://api.supadata.ai/v1/transcript" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt" -d "text=true"'

# Instagram Reel
bash -c 'curl -s "https://api.supadata.ai/v1/transcript" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt" -d "text=true"'

Supported platforms: YouTube, TikTok, Instagram, X (Twitter), Facebook

4. Native Transcript Only (Save Credits)

Fetch only existing transcripts without AI generation:

bash

bash -c 'curl -s "https://api.supadata.ai/v1/transcript" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt" -d "text=true" -d "mode=native"'

Use

mode=native

to avoid AI generation costs (1 credit vs 2 credits/min).

5. Get YouTube Channel Metadata

Get channel information:

bash

bash -c 'curl -s "https://api.supadata.ai/v1/youtube/channel" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "id=@mkbhd"' | jq '{name, subscriberCount, videoCount}

Accepts channel URL, channel ID, or handle (e.g.,

@mkbhd

6. Get YouTube Video Metadata

Get video information:

bash

bash -c 'curl -s "https://api.supadata.ai/v1/youtube/video" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt"' | jq '{title, viewCount, likeCount, duration}

7. Get Social Media Metadata

Get metadata from any supported platform:

bash

bash -c 'curl -s "https://api.supadata.ai/v1/metadata" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt"'

Works with YouTube, TikTok, Instagram, X, Facebook posts.

8. Scrape Web Page to Markdown

Extract web page content:

bash

bash -c 'curl -s "https://api.supadata.ai/v1/web/scrape" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt"'

Returns page content in Markdown format, ideal for AI processing.

9. Map Website Links

Get all links from a website:

bash

bash -c 'curl -s "https://api.supadata.ai/v1/web/map" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt"' | jq '.urls[:10]'

10. Crawl Website (Async)

Start a crawl job for multiple pages.

Write to

/tmp/supadata_request.json

json

{
  "url": "https://example.com",
  "maxPages": 10
}

Then run:

bash

# Start crawl
JOB_ID="$(bash -c 'curl -s "https://api.supadata.ai/v1/web/crawl" -X POST -H "x-api-key: ${SUPADATA_API_KEY}" -H "Content-Type: application/json" -d @/tmp/supadata_request.json' | jq -r '.jobId')"

echo "Job ID: ${JOB_ID}"

# Check status
bash -c 'curl -s "https://api.supadata.ai/v1/web/crawl/<your-job-id>" -H "x-api-key: ${SUPADATA_API_KEY}"' | jq '{status, pagesCompleted}'

Status values:

queued

active

completed

failed

11. Translate Transcript

Translate a YouTube transcript to another language:

bash

bash -c 'curl -s "https://api.supadata.ai/v1/youtube/transcript/translate" -H "x-api-key: ${SUPADATA_API_KEY}" -G --data-urlencode "url@/tmp/supadata_url.txt" -d "lang=zh" -d "text=true"'

Response Handling

Synchronous (HTTP 200): Direct result returned.

Asynchronous (HTTP 202): Returns

jobId

for polling:

json

{"jobId": "abc123"}

Poll the job endpoint until status is

completed

Guidelines

Use
mode=native
to save credits: Only fetches existing transcripts
URL encode parameters: Use
```
--data-urlencode
```
for URLs
Check available languages: Response includes
```
availableLangs
```
array
Handle async responses: Some requests return job IDs for polling
Max file size: 1GB for direct file URLs
Supported formats: MP4, WEBM, MP3, FLAC, MPEG, M4A, OGG, WAV

supadata

NPX Install

Tags

SKILL.md Content

Supadata API

When to Use

Prerequisites

Pricing

How to Use

1. Get YouTube Video Transcript

2. Get Transcript with Timestamps

3. Get TikTok/Instagram/X Transcript

4. Native Transcript Only (Save Credits)

5. Get YouTube Channel Metadata

6. Get YouTube Video Metadata

7. Get Social Media Metadata

8. Scrape Web Page to Markdown

9. Map Website Links

10. Crawl Website (Async)

11. Translate Transcript

Response Handling

Guidelines