Guides & Tutorials

Step-by-step setup for every integration path.

Quick Start

Three steps to your first transcript:

1. Sign up at subdownload.com/account to get 1,000 free credits.
2. Copy your API key (starts with sk_live_).
3. Call the API with your key in the Authorization header.

curl -H "Authorization: Bearer sk_live_xxx"   "https://api.subdownload.com/v1/youtube/transcript?video_id=dQw4w9WgXcQ"

import requests

API_KEY = "sk_live_xxx"
BASE = "https://api.subdownload.com/v1"

r = requests.get(
    f"{BASE}/youtube/transcript",
    params={"video_id": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
r.raise_for_status()
data = r.json()
print(data["data"]["text"][:200])

const API_KEY = "sk_live_xxx";

const res = await fetch(
  "https://api.subdownload.com/v1/youtube/transcript?video_id=dQw4w9WgXcQ",
  { headers: { Authorization: "Bearer " + API_KEY } }
);
if (!res.ok) throw new Error("HTTP " + res.status);
const data = await res.json();
console.log(data.data.text.slice(0, 200));

// Never hardcode your API key in client-side code.
// Proxy through your own backend instead.
const res = await fetch("/api/my-proxy/transcript?video_id=dQw4w9WgXcQ");
const data = await res.json();
console.log(data);

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer sk_live_xxxxx

• • API keys are prefixed with sk_live_.
• • Keys never expire unless manually revoked or regenerated.
• • Store keys in environment variables — never in client-side code or public repos.
• • Manage keys at subdownload.com/account.

Verify a key works: GET /v1/verify (free, no credits charged).

Claude (Desktop / Code) Setup

Claude supports OAuth with Dynamic Client Registration — no pre-created credentials needed.

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp"
    }
  }
}

Claude opens a browser to authorize. Tokens are refreshed automatically.

Or use a static API key (no OAuth):

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_xxx" }
    }
  }
}

ChatGPT (GPT Actions / Custom Connectors)

ChatGPT uses static OAuth clients. Steps:

1. Go to your account → MCP / OAuth tab.
2. Copy Client ID and Client Secret.
3. In ChatGPT, add a new Connector / Action with:
   • MCP URL: https://api.subdownload.com/mcp
   • Auth: OAuth with your Client ID & Secret

OpenAI Agent Builder

Paste your API key directly as the authentication method (Bearer token). The server URL is https://api.subdownload.com/mcp.