Supadata connector

API KeyAnalyticsSearch

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

Supadata connector

Install the SDK
Section titled “Install the SDK”
- Node.js
- Python
Terminal window
1 npm install @scalekit-sdk/node
Terminal window
1 pip install scalekit
Full SDK reference: Node.js | Python
Set your credentials
Section titled “Set your credentials”

Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Set up the connector
Section titled “Set up the connector”

Register your Supadata credentials with Scalekit so it can authenticate requests on your behalf. You do this once per environment.
Dashboard setup steps
Register your Scalekit environment with the Supadata connector so Scalekit can proxy API requests and inject your API key automatically. Unlike OAuth connectors, Supadata uses API key authentication — there is no redirect URI or OAuth flow.
1. Get a Supadata API key
  
  Your Supadata API key is generated automatically when you create an account.
  - Go to dash.supadata.ai and sign up or sign in. No credit card is required for the free tier.
  - After signing in, click API Keys in the left sidebar.
  - Your auto-generated key is listed in the table. Click the key row to reveal or copy it.
  - To create a new dedicated key for this integration, click + New Key, give it a name (e.g., Agent Auth), and click Create.
  Supadata uses a credit-based billing model. Different tools consume different amounts of credits per request:
  
  Plan Monthly credits Rate limit
  Free 100 credits 1 req/s
  Pro ($9/mo) 5,000 credits 10 req/s
  Ultra ($29/mo) 20,000 credits 50 req/s
  Mega ($59/mo) 50,000 credits 100 req/s
  Upgrade your plan at dash.supadata.ai → Billing.
2. Create a connection in Scalekit
  - In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Supadata and click Create.
  - Note the Connection name — you will use this as connection_name in your code (e.g., supadata).
  - Click Save.
3. Add a connected account
  
  Connected accounts link a specific user identifier in your system to a Supadata API key. Add them via the dashboard for testing, or via the Scalekit API in production.
  
  Via dashboard (for testing)
  - Open the connection you created and click the Connected Accounts tab → Add account.
  - Fill in:
    - Your User’s ID — a unique identifier for this user in your system (e.g., user_123)
    - API Key — the Supadata API key you copied in step 1
  - Click Save.
  Via API (for production)
  Node.js
  Python
  1 // Never hard-code API keys — read from secure storage or user input 2 const supadataApiKey = getUserSupadataKey(); // retrieve from your secure store 3 4 await scalekit.actions.upsertConnectedAccount({ 5 connectionName: 'supadata', 6 identifier: 'user_123', // your user's unique ID 7 credentials: { api_key: supadataApiKey }, 8 });
  1 # Never hard-code API keys — read from secure storage or user input 2 supadata_api_key = get_user_supadata_key() # retrieve from your secure store 3 4 scalekit_client.actions.upsert_connected_account( 5 connection_name="supadata", 6 identifier="user_123", 7 credentials={"api_key": supadata_api_key} 8 )
  In production, call upsert_connected_account (Python) / upsertConnectedAccount (Node.js) when a user enters their Supadata API key — for example, on a settings page in your app.
Each API key has plan-specific rate limits. The Free plan allows 1 request/second. Exceeding your credit quota returns a 402 Payment Required error. Monitor your usage at dash.supadata.ai → Usage.

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENV_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'supadata'
12
const identifier = 'user_123'
13

14
// Make your first call
15
const result = await actions.executeTool({
16
  connector,
17
  identifier,
18
  toolName: 'supadata_metadata_get',
19
  toolInput: { url: 'https://example.com/url' },
20
})
21
console.log(result)

1
import os
2
from scalekit.client import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENV_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "supadata"
14
identifier = "user_123"
15

16
# Make your first call
17
result = actions.execute_tool(
18
    tool_input={"url":"https://example.com/url"},
19
    tool_name="supadata_metadata_get",
20
    connection_name=connection_name,
21
    identifier=identifier,
22
)
23
print(result)

What you can do

Connect this agent connector to let your agent:

Get metadata, youtube playlist, youtube channel — Retrieve unified metadata for a video or media URL including title, description, author info, engagement stats, media details, and creation date
Scrape web — Scrape a web page and return its content as clean Markdown
Search youtube — Search YouTube for videos, channels, or playlists
Map web — Discover and return all URLs found on a website
Translate youtube transcript — Retrieve and translate a YouTube video transcript into a target language

Common workflows

Proxy API call

Node.js
Python

1
// Get a YouTube transcript — no API key needed here
2
const result = await actions.request({
3
  connectionName: 'supadata',
4
  identifier: 'user_123',
5
  path: '/v1/youtube/transcript',
6
  method: 'GET',
7
  queryParams: { videoId: 'dQw4w9WgXcQ', text: 'true' },
8
});
9
console.log(result);

1
# Get a YouTube transcript — no API key needed here
2
result = actions.request(
3
    connection_name='supadata',
4
    identifier='user_123',
5
    path="/v1/youtube/transcript",
6
    method="GET",
7
    params={"videoId": "dQw4w9WgXcQ", "text": True}
8
)
9
print(result)

Execute a tool

Node.js
Python

1
const result = await actions.executeTool({
2
  connector: 'supadata',
3
  identifier: 'user_123',
4
  toolName: 'supadata_metadata_get',
5
  toolInput: {},
6
});
7
console.log(result);

1
result = actions.execute_tool(
2
    tool_input={},
3
    tool_name='supadata_metadata_get',
4
    connection_name='supadata',
5
    identifier='user_123',
6
)
7
print(result)

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

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.

NameTypeRequiredDescription

urlstringrequiredURL 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.

NameTypeRequiredDescription

urlstringrequiredURL of the video or media file to transcribe. Supports YouTube, TikTok, Instagram, X, Facebook, or direct video/audio file URLs.

chunkSizeintegeroptionalMaximum number of characters per transcript segment chunk.

langstringoptionalISO 639-1 language code for the transcript (e.g., en, fr, de). Defaults to the video's original language.

modestringoptionalTranscript generation mode: native (use existing captions, 1 credit), auto (native with AI fallback), or generate (AI-generated, 2 credits/minute).

textbooleanoptionalReturn 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.

NameTypeRequiredDescription

urlstringrequiredBase 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.

NameTypeRequiredDescription

urlstringrequiredURL of the web page to scrape.

langstringoptionalISO 639-1 language code to request content in a specific language (e.g., en, fr, de).

noLinksbooleanoptionalStrip 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.

NameTypeRequiredDescription

channelIdstringrequiredYouTube 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.

NameTypeRequiredDescription

playlistIdstringrequiredYouTube 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.4 params

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

NameTypeRequiredDescription

querystringrequiredSearch query string to find videos, channels, or playlists on YouTube.

langstringoptionalISO 639-1 language code to filter results by language (e.g., en, fr).

limitintegeroptionalMaximum number of results to return.

typestringoptionalType 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.3 params

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

NameTypeRequiredDescription

videoIdstringrequiredYouTube video ID or full YouTube URL to retrieve the transcript for.

langstringoptionalISO 639-1 language code for the transcript (e.g., en, fr, de).

textbooleanoptionalReturn 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.

NameTypeRequiredDescription

langstringrequiredISO 639-1 language code to translate the transcript into (e.g., en, fr, es).

videoIdstringrequiredYouTube video ID or full YouTube URL to translate the transcript for.

textbooleanoptionalReturn 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.

NameTypeRequiredDescription

videoIdstringrequiredYouTube video ID or full YouTube URL.

Plan	Monthly credits	Rate limit
Free	100 credits	1 req/s
Pro ($9/mo)	5,000 credits	10 req/s
Ultra ($29/mo)	20,000 credits	50 req/s
Mega ($59/mo)	50,000 credits	100 req/s

Supadata connector

Supadata connector

Install the SDK

Set your credentials

Set up the connector

Get a Supadata API key

Create a connection in Scalekit

Add a connected account

Make your first call

What you can do

Common workflows

Tool list