# ScriptHaul API

> Find YouTube videos, deliver transcripts and bulk archives, search indexed passages within a channel or video, and monitor new uploads. Connect with REST, SDKs, MCP, OAuth, or an agent skill. No video or audio download.

- [Quickstart](https://api.scripthaul.com/docs): Get a ScriptHaul API key, fetch a transcript, and choose a workflow for discovery, bulk delivery, library search, or connected assistants.
- [Authentication and keys](https://api.scripthaul.com/docs/authentication): Passwordless accounts, Bearer authentication, key rotation, revocation, and dashboard sessions.
- [Transcripts and languages](https://api.scripthaul.com/docs/transcripts): Fetch transcripts in seven formats with explicit requested, delivered, fallback, and translation fields.
- [Video facts](https://api.scripthaul.com/docs/video-facts): Inspect known video metadata and cached transcript languages without spending credits.
- [YouTube search](https://api.scripthaul.com/docs/search): Find YouTube videos, channels, and playlists, or search inside one channel, for one credit per delivered page.
- [Channels and latest uploads](https://api.scripthaul.com/docs/channels): Resolve a YouTube channel and read its newest uploads, or a playlist's newest entries, at zero credits.
- [Listing videos](https://api.scripthaul.com/docs/listing): Enumerate channels and playlists with offsets, cached flags, Shorts membership, and cold counts.
- [Transcript library](https://api.scripthaul.com/docs/library): Check caption coverage, fill missing videos with a job, and search scoped passages with timestamp citations at zero credits.
- [Channel monitors](https://api.scripthaul.com/docs/monitors): Watch channel or playlist RSS feeds, optionally fetch new captions through ordinary jobs, and receive signed events.
- [Pasted lists and subsets](https://api.scripthaul.com/docs/pasted-lists): Resolve text containing YouTube links into a stable validated list and select a subset safely.
- [Bulk jobs](https://api.scripthaul.com/docs/bulk-jobs): Run up to 500 videos through the durable queue with reservations, manifests, files, archives, progress, retry, and cancel.
- [Credits and limits](https://api.scripthaul.com/docs/credits-limits): One screen for ScriptHaul credit rules, free and paid caps, headers, and global capacity guards.
- [Errors](https://api.scripthaul.com/docs/errors): Typed ScriptHaul API errors, HTTP statuses, retry rules, request IDs, and recovery actions.
- [Webhooks](https://api.scripthaul.com/docs/webhooks): Configure an HTTPS endpoint, verify signed events, and inspect bounded delivery retries without exposing bodies.
- [Languages and strict mode](https://api.scripthaul.com/docs/languages): Read requested and delivered caption language honestly, including fallback and translation outcomes.
- [MCP](https://api.scripthaul.com/docs/mcp): Connect agents to the keyless discovery server or the authenticated, metered API server.
- [Migrating from transcriptapi.com](https://api.scripthaul.com/docs/migrating): Map transcriptapi.com requests and billing assumptions to ScriptHaul API.
- [Claude MCP setup](https://api.scripthaul.com/docs/mcp/claude): Connect Claude on the web or desktop to ScriptHaul with OAuth, or try the keyless server.
- [Claude Code MCP setup](https://api.scripthaul.com/docs/mcp/claude-code): Add ScriptHaul to Claude Code over HTTP, sign in with OAuth, or configure an API key.
- [Cursor MCP setup](https://api.scripthaul.com/docs/mcp/cursor): Install ScriptHaul in Cursor with one click and connect your account through OAuth.
- [VS Code MCP setup](https://api.scripthaul.com/docs/mcp/vscode): Install ScriptHaul in VS Code, authorize your account, or try its keyless server.
- [ChatGPT MCP setup](https://api.scripthaul.com/docs/mcp/chatgpt): Connect ScriptHaul to ChatGPT through OAuth using a developer-mode remote MCP connection.
- [Windsurf MCP setup](https://api.scripthaul.com/docs/mcp/windsurf): Connect Windsurf to ScriptHaul over Streamable HTTP with OAuth or an environment-supplied API key.
- [OpenAI Agents SDK MCP setup](https://api.scripthaul.com/docs/mcp/openai-agents): Connect a Python OpenAI agent to ScriptHaul's hosted MCP tools with an API key or no authentication.
- [n8n MCP setup](https://api.scripthaul.com/docs/mcp/n8n): Connect an n8n AI Agent to ScriptHaul with its Streamable HTTP MCP Client Tool and OAuth or an API key.
- [Agent skill](https://api.scripthaul.com/docs/skills): Install ScriptHaul instructions for discovery, captions, scoped library search, monitors, and durable exports.
- [Changelog](https://api.scripthaul.com/docs/changelog): Dated changes to the ScriptHaul API contract and developer surface.
- [OpenAPI](https://api.scripthaul.com/openapi.json): OpenAPI 3.1 machine contract.
- [Runnable examples](https://api.scripthaul.com/docs/examples): curl, Node, Python, Go, and n8n workflow exports.
- [Agent Skill index](https://api.scripthaul.com/.well-known/agent-skills/index.json): Integrity-pinned agent instructions.
- [Keyed MCP server card](https://api.scripthaul.com/mcp/server-card): Experimental remote-discovery card.