API

YouTubeForge for developers

Same caption engine as the website. Authenticate with x-api-key (or Authorization: Bearer …). Billing via Lemon Squeezy.

See pricingPlans

Auth

curl -sS 'https://forgeyt.com/api/transcript?v=VIDEO_ID&fmt=json' \
  -H 'x-api-key: forge_sk_live_…' \
  -H 'Accept: application/json'

Endpoints

  • GET /api/transcriptv or url, optional lang, tlang, fmt=json|txt|srt|vtt|md|timed. Counts as one transcript credit.
  • POST /api/translate — JSON body with cues + tlang. Counts as one translate credit.
  • GET /api/audiov + fmt=mp3|m4a|opus|wav. Basic/Pro monthly audio caps.
  • GET /api/video — Pro only (SD / 720). Pass q=480|720. HD not sold on the API.
  • GET /api/v1/me — plan + usage counters for the calling key.

Limits

Monthly quotas reset with your Lemon billing period. Burst rate is per key (Basic 120/min, Pro 300/min). Free website traffic still uses network limits and proof-of-work for downloads — paid keys skip the bot gate.

Errors

JSON {"error":"…"} with 429 when a monthly meter is exhausted, 401 on /api/v1/me without a key, and 404 for anonymous cross-site scrapers (same-site UI still works).