The YouTube transcript API that does whole channels.

1 credit per delivered page

Search YouTube

Find videos, channels and playlists without knowing a URL. Video results show what is already cached.

• GET /v1/search

• Keyed MCP search_youtube

1 credit per delivered page

Search within a channel

Add a channel handle or ID to the same search. Continue through results one page at a time.

• GET /v1/search

• Keyed MCP search_youtube

Use q=your topic and channel=@TED.

0 credits

See the latest uploads

Read the newest 15 entries from a channel or playlist, with a ten-minute cache. Use a channel ID or an already-resolved handle.

• GET /v1/channels/latest

• Keyed + keyless MCP get_latest_videos

0 credits

Resolve a channel

Turn a handle or channel URL into a stable channel ID, title and uploads playlist.

• GET /v1/channels/resolve

• Keyed MCP resolve_channel

0 credits · cold enumeration allowance applies

List a channel or playlist

Inspect up to 500 videos per enumeration, including dates and cache flags, before deciding what to fetch.

• GET /v1/videos

• Keyed + keyless MCP list_videos

0 credits · cold enumeration allowance applies

Bring a pasted list

Validate YouTube links or IDs and get a reusable list key for enumeration and bulk jobs.

• POST /v1/videos/resolve

1 credit per cold delivery · cache hits 0

Fetch one transcript

Request a video by URL or ID. A slow cold fetch returns a poll URL; a cached transcript is ready to read.

• GET /v1/transcript

• Keyed + keyless MCP get_transcript

Keyless MCP costs 0 credits within its small daily allowance.

0 extra credits for the format

Choose any of seven formats

Clean text, timestamped text, both together, SRT, VTT, Markdown or JSON. Use raw=1 for a file response.

• GET /v1/transcript

• Keyed + keyless MCP get_transcript

1 credit per cold delivery · refusals 0

Choose language and strict mode

See requested and delivered language, caption kind and translation verdict. With fallback=false, a strict refusal costs nothing.

• GET /v1/transcript

• Keyed MCP get_transcript

Available caption tracks are also listed by GET /v1/video.

300 credits per started 10,000 characters of transcript (at most 1,500), on top of the delivery credit

Get the language you asked for

When YouTube declines to translate the captions, add translate=true to a transcript request or a bulk job to receive the requested language anyway, labelled like any served translation. Later requests for it are cache hits.

• GET /v1/transcript
• POST /v1/jobs

• Keyed MCP get_transcript
• Keyed MCP create_bulk_job

Opt-in, in most languages. Nothing extra is charged when it cannot be delivered.

0 credits

Read known video facts

Get the title, channel, publish date, duration, available caption tracks and durable fetch outcome when known.

• GET /v1/video

Creation 0 · each cold delivery 1 credit

Create a durable bulk job

Submit a channel, playlist or up to 500 video IDs. Jobs reserve cold work, settle successful deliveries and pause when credits run out.

• POST /v1/jobs

• Keyed MCP create_bulk_job

0 credits

Follow jobs and video rows

List account jobs, inspect progress and credit totals, or page through individual videos and failures.

• GET /v1/jobs
• GET /v1/jobs/{jobId}
• GET /v1/jobs/{jobId}/videos

• Keyed MCP get_job

0 credits

Read a download manifest

Get a machine-readable list of delivered files, language facts and integrity metadata.

• GET /v1/jobs/{jobId}/manifest

0 credits

Download individual files

Retrieve a job video in the requested format, with account authorization on every file request.

• GET /v1/jobs/{jobId}/files/{videoId}

0 credits

Collect a ZIP archive

Build a server-side archive in one or more formats. Large exports are split into bounded parts.

• GET /v1/jobs/{jobId}/archive

0 credits

Stream job events

Follow progress as server-sent events and reconnect from the last event you received.

• GET /v1/jobs/{jobId}/events

Actions 0 · a successful cold retry 1 credit

Retry or cancel work

Retry eligible failures or cancel unfinished work. Credits settle only for successful cold deliveries.

• POST /v1/jobs/{jobId}/retry
• POST /v1/jobs/{jobId}/cancel

0 credits

Receive signed webhooks

Configure, read, rotate or remove an endpoint for job completion, credit events and new monitored uploads.

• GET /v1/webhooks
• PUT /v1/webhooks
• DELETE /v1/webhooks

0 credits

Open the free bulk tool

Ask an assistant for a prefilled channel or playlist download link on scripthaul.com.

• Keyed + keyless MCP get_bulk_download_link

0 credits

Check library coverage

See known, indexed and missing videos plus the cold count. Use the suggested job to fill the gaps.

• GET /v1/library

• Keyed MCP get_library

0 credits · daily search allowance applies

Search transcript passages

Search a named channel or video with phrases and prefixes. Ranked passages include a link to the exact video timestamp.

• GET /v1/library/search

• Keyed MCP search_transcripts

Monitoring 0 · auto-fetch cold delivery 1 credit

Watch for new uploads

Monitor a channel or playlist through RSS. Optional auto-fetch creates ordinary jobs so new uploads enter the library.

• POST /v1/monitors

• Keyed MCP watch_channel

1 monitor free; 25 on paid accounts. Checks are at least 15 minutes apart.

0 credits

Manage your monitors

List watches, inspect the last check and new-video count, or cancel. Automatic fetching pauses for credits and resumes after a purchase.

• GET /v1/monitors
• GET /v1/monitors/{monitorId}
• DELETE /v1/monitors/{monitorId}

• Keyed MCP list_monitors

0 credits to connect · endpoint costs apply

REST, SDKs and examples

Use the interactive OpenAPI reference, JavaScript and Python SDKs, or runnable curl, Node, Python, Go and n8n examples.

Runnable examples · n8n setup

0 credits to connect · tool costs apply

Connect an assistant with OAuth

Connect Claude, ChatGPT and other MCP clients with email-code consent, or use an API key. Revoke connected apps from the dashboard.

https://api.scripthaul.com/mcp
Try the keyless server: https://scripthaul.com/mcp

0 credits to install · tool costs apply

Install the agent skill

Give an assistant instructions for discovery, bulk work, timestamped library research and monitors.

/.well-known/agent-skills · MCP server card

0 credits

Sign in with an email code

Request and verify a sign-in code, then sign out when finished. Keep keys in a secret manager and send them only as Bearer headers.

• POST /v1/auth/code
• POST /v1/auth/verify
• POST /v1/auth/logout

0 credits

Manage API keys

List or create keys, change names and daily credit caps, revoke keys or rotate with a 24-hour migration grace period.

• GET /v1/keys
• POST /v1/keys
• POST /v1/keys/{keyId}
• DELETE /v1/keys/{keyId}
• POST /v1/keys/{keyId}/rotate

0 credits

Manage your account

Read balance and limits, manage dashboard webhook settings and connected apps, or close the account.

• GET /v1/account
• PUT /v1/account
• DELETE /v1/account

Dashboard modes: resource=webhook, resource=connected_apps and resource=account.

0 credits

Audit usage and credits

Read usage rollups and the itemized ledger; export the ledger as CSV from the dashboard.

• GET /v1/usage

Use resource=ledger for individual credit entries.

0 API credits · purchases are charged in USD

Buy credits and manage receipts

Open checkout, request an eligible refund, and visit the billing portal for receipts and invoices. Stripe sends signed payment events to the callback.

• POST /v1/checkout
• GET /v1/billing/portal
• POST /v1/billing/stripe

Use action=refund on checkout for refund requests.

0 credits

Check service status

Read API status before starting work, or use a lightweight HEAD request from your uptime monitor.

• GET /v1/status
• HEAD /v1/status