# Youtube Transcript Fetcher

## Links

- Product page URL: https://www.agentpmt.com/marketplace/youtube-transcript-fetcher
- Product markdown URL: https://www.agentpmt.com/marketplace/youtube-transcript-fetcher?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/youtube-transcript-fetcher?format=agent-json

## Overview

- Product ID: 693389cb6f4ce728406d40be
- Vendor: Apoth3osis
- Type: connector
- Unit type: request
- Price: 2500 credits
- Categories: Web Scraping & Data Collection, Automation, Network & URL Utilities
- Generated at: 2026-05-30T20:18:44.332Z

### Page Description

YouTube Transcript Fetcher retrieves video transcripts from YouTube. The tool accepts either a full YouTube URL or an 11-character video ID. Supported URL formats include standard watch URLs (youtube.com/watch?v=), shortened URLs (youtu.be), Shorts, embeds, and live streams. When both are provided, video_id takes precedence over video_url. Transcripts are returned as plain text by default. Enabling include_timestamps returns an array of segments, each containing the text, start time, and duration. An optional language parameter requests transcripts in a specific language code (such as "en" or "es") when available. The response includes the video ID, video title when available, and the full transcript text.

### Agent Description

Fetch YouTube video transcripts by URL or video ID. Returns plain text or timestamped segments. Multi-language support.

## Details

### Details

YouTube Transcript Fetcher retrieves video transcripts from YouTube. The tool accepts either a full YouTube URL or an 11-character video ID. Supported URL formats include standard watch URLs (youtube.com/watch?v=), shortened URLs (youtu.be), Shorts, embeds, and live streams. When both are provided, video_id takes precedence over video_url. Transcripts are returned as plain text by default. Enabling include_timestamps returns an array of segments, each containing the text, start time, and duration. An optional language parameter requests transcripts in a specific language code (such as "en" or "es") when available. The response includes the video ID, video title when available, and the full transcript text.

### Actions

- `fetch` (25 credits): Fetch the transcript for a YouTube video. Provide either video_url or video_id. The transcript is saved to cloud storage and a signed download URL is returned.

### Use Cases

Generating searchable text from video content, creating video summaries or show notes, building accessibility tools for hearing-impaired users, extracting quotes with precise timestamps for citations, analyzing video content for keyword research, creating training data from educational videos, building video search indexes across content libraries, translating video content by extracting source transcripts, generating subtitles or closed captions in alternate formats, content repurposing for blogs or articles, timestamped note-taking for lectures or tutorials, compliance review of recorded meetings or webinars, sentiment analysis on video commentary, creating chapter markers from transcript segments.

### Workflows Using This Tool

#### YouTube Transcript -> Newsletter Draft (Gmail)

Fetch a YouTube transcript, extract the best insights/quotes, and create a polished newsletter draft in Gmail.

- Page URL: https://www.agentpmt.com/agent-workflow-skills/youtube-transcript-newsletter-draft-gmail
- Markdown URL: https://www.agentpmt.com/agent-workflow-skills/youtube-transcript-newsletter-draft-gmail?format=agent-md
- Published: 2026-02-19T20:11:50.002Z

### Related Content

No related content is currently linked to this product.

## Integration Details

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

Use the local router for command-based MCP clients. It forwards requests to `https://api.agentpmt.com/mcp` and does not execute tools locally.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "693389cb6f4ce728406d40be",
    "parameters": {
      "action": "fetch",
      "include_timestamps": false,
      "include_raw_response": false
    }
  }'
```

### Autonomous Agents

Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below.

- Autonomous Agent API reference URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents
- Autonomous Agent API reference markdown URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents?format=agent-md
- Credit-Based Access Using AgentAddress: https://www.agentpmt.com/docs/autonomous-agents/credit-based-tool-usage-with-agentaddress
- AgentAddress is preferred for persistent file access, stored platform state, and maximum tool use ability across repeated calls.
- Direct x402 is for independent one-off tool calls that do not require shared files or stored platform state.
- Direct x402 public payments: USDC on Base, Arbitrum, Optimism, Polygon, and Avalanche.

### Schema

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "fetch": {
      "description": "Fetch the transcript for a YouTube video. Provide either video_url or video_id. The transcript is saved to cloud storage and a signed download URL is returned.",
      "properties": {
        "video_url": {
          "type": "string",
          "description": "Full YouTube URL. Supported formats: youtube.com/watch?v=, youtu.be/, shorts, embeds, live. Provide either video_url or video_id.",
          "required": false
        },
        "video_id": {
          "type": "string",
          "description": "YouTube video ID (11 characters). Takes precedence over video_url if both are provided.",
          "required": false
        },
        "language": {
          "type": "string",
          "description": "Transcript language code (e.g., 'en', 'es', 'fr'). If omitted, the video's default language is used.",
          "required": false
        },
        "include_timestamps": {
          "type": "boolean",
          "description": "When true, the saved transcript file includes timestamped segments with start time and duration. Default: false.",
          "required": false,
          "default": false
        },
        "include_raw_response": {
          "type": "boolean",
          "description": "When true, the saved transcript file includes the full raw provider response (useful for debugging; may be large). Default: false.",
          "required": false,
          "default": false
        }
      }
    }
  },
  "properties": {}
}
```

### Usage Instructions

# Youtube Transcript Fetcher

## Overview
Fetch transcripts from YouTube videos. Provide a video URL or video ID and receive the full transcript text saved as a downloadable JSON file. Supports language selection and optional timestamped segments.

## Actions

### fetch
Retrieve the transcript for a YouTube video. The transcript is saved to cloud storage and a signed download URL is returned.

**Required fields (one of the following):**
- `video_url` (string) — Full YouTube URL. Supported formats include `https://www.youtube.com/watch?v=VIDEO_ID`, `https://youtu.be/VIDEO_ID`, shorts, embeds, and live URLs.
- `video_id` (string) — The 11-character YouTube video ID. Takes precedence over `video_url` if both are provided.

**Optional fields:**
- `language` (string) — Language code for the transcript (e.g., `en`, `es`, `fr`). If omitted, the video's default language is used.
- `include_timestamps` (boolean, default: `false`) — When `true`, the saved transcript file includes timestamped segments with start time and duration for each line.
- `include_raw_response` (boolean, default: `false`) — When `true`, the saved transcript file includes the full raw provider response (useful for debugging; may be large).

**Example — Fetch by video URL:**
```json
{
  "action": "fetch",
  "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
```

**Example — Fetch by video ID with timestamps in Spanish:**
```json
{
  "action": "fetch",
  "video_id": "dQw4w9WgXcQ",
  "language": "es",
  "include_timestamps": true
}
```

**Example — Fetch with raw response for debugging:**
```json
{
  "action": "fetch",
  "video_id": "dQw4w9WgXcQ",
  "include_raw_response": true
}
```

**Response fields:**
- `video_id` — The resolved video ID.
- `video_title` — Title of the video (when available).
- `language` — The requested language code (or null if default).
- `transcript_file` — Object containing `file_id`, `filename`, `signed_url`, `signed_url_expires_in`, `expiration_date`, `size_bytes`, and `content_type`. Use `signed_url` to download the full transcript JSON.
- `transcript_summary` — Object with `character_count`, `word_count`, and `segment_count`.
- `timestamps_saved` — Whether timestamped segments were included in the file.

## Common Workflows

1. **Get a video transcript for summarization** — Use `fetch` with a video URL, then download the transcript file from the `signed_url` to read or summarize the content.
2. **Multilingual transcript retrieval** — Set the `language` field to fetch transcripts in a specific language (the video must have that language available).
3. **Detailed analysis with timestamps** — Set `include_timestamps` to `true` to get per-segment timing data, useful for creating subtitles or referencing specific moments.

## Important Notes
- You must provide either `video_url` or `video_id`. If both are given, `video_id` takes precedence.
- The transcript is returned as a stored JSON file with a signed download URL, not inline in the response. Use the `signed_url` to access the full text.
- Not all YouTube videos have transcripts available. Videos without captions or transcripts will return an error.
- The `signed_url` is temporary and will expire (see `signed_url_expires_in` and `expiration_date` in the response).
- Supported URL formats: standard watch URLs, short youtu.be links, shorts, embeds, and live URLs.

### Frequently Asked Questions

#### How do I connect this tool to an external agent?

- Page URL: https://www.agentpmt.com/faq
- Markdown URL: https://www.agentpmt.com/faq?format=agent-md

You can install the local MCP server by opening a terminal and running:

```
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

```
{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}
```

[View MCP Connection Instructions](/docs/mcp-reference/connection) for more details.

#### How does an external agent use this tool?

- Page URL: https://www.agentpmt.com/faq
- Markdown URL: https://www.agentpmt.com/faq?format=agent-md

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

> Call the AgentPMT-Tool-Search-and-Execution tool with action 'get\_schema' and tool\_id 693389cb6f4ce728406d40be ("Youtube Transcript Fetcher"). Then call the same tool with action 'call\_tool', tool\_id 693389cb6f4ce728406d40be, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

### Dependencies

This product has no public dependency products.