# YouTube Shorts Transcript Scraper by Channel - Text per Short (`tenfoldfleet/youtube-shorts-transcript-by-channel`) Actor

Get the transcript of every recent YouTube Short of a channel in one run: paste @handles or Shorts URLs, get one row per Short with transcript text, timed segments, language, title, views, likes and date. New-only monitor mode. $4 per 1,000 transcripts; a Short with no captions costs nothing.

- **URL**: https://apify.com/tenfoldfleet/youtube-shorts-transcript-by-channel.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** Videos, Agents, For creators
- **Features:** Limited permissions
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 shorts transcripts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does YouTube Shorts Transcript Scraper by Channel do?

**YouTube Shorts Transcript Scraper by Channel** turns the Shorts of any [YouTube](https://www.youtube.com) channel into text. Give it one or more **channel @handles** (or a list of Shorts links) and it returns **one row per Short with its transcript**, the timed caption segments, the caption language and the Short's title, views, likes, duration and publish date.

Not affiliated with YouTube or Google. It reads public pages only: no login, no cookies, no API key.

You do not have to collect video links first. One run reads the newest Shorts of every channel you list, and the **new-only monitor** returns each Short's transcript once, so a daily schedule costs you only what was published since the last run.

It works as a **YouTube Shorts transcript API** on plain HTTP requests (no browser): **$4 per 1,000 transcripts**, and you pay **only for Shorts that come back with a transcript**.

#### Which of our YouTube Actors should I use?

| You have | You want | Use |
|---|---|---|
| A channel @handle or Shorts links | The transcript of every Short | **This Actor** |
| Links of individual videos (long or short) | Transcripts in several languages | [YouTube Captions Downloader](https://apify.com/tenfoldfleet/youtube-transcript-scraper): it takes video links only, not channels |
| A channel or #hashtag | Shorts statistics: views, likes, comments, hashtags | [YouTube Shorts Analytics Scraper](https://apify.com/tenfoldfleet/youtube-shorts-scraper): it returns no transcripts |

This Actor handles Shorts only. For long-form videos, pass their links to the Captions Downloader.

### Why get YouTube Shorts transcripts by channel?

- **Competitor and creator research**: read what a channel says in its Shorts, find hooks and recurring topics.
- **Content repurposing**: turn your own Shorts into posts, captions, newsletters and scripts.
- **AI and LLM workflows**: feed Shorts transcripts into summaries, RAG pipelines or trend classifiers.
- **Monitoring**: schedule a run and get the text of every new Short of the channels you follow.
- **Brand and product mentions**: search the spoken words of a channel's Shorts.

It runs on the Apify platform, so you get an **API**, scheduling, webhooks and integrations with Make, Zapier, n8n and LangChain.

### What data can it extract?

![Sample output of YouTube Shorts Transcript Scraper by Channel, rows from a real run: Channel, Title, URL, Transcript, Language, Auto captions](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/youtube-shorts-transcript-by-channel-output.png)

| Field | Example |
|---|---|
| `channel`, `channelId` | `Marques Brownlee`, `UCBJycsmduvYEL83R_U4JriQ` |
| `videoId`, `url` | `ai1gIWacf0I`, `https://www.youtube.com/shorts/ai1gIWacf0I` |
| `title` | `This can SEE Sound!` |
| `publishedAt` | `2026-10-27` (date) |
| `views`, `likes` | `2758266`, `77374` |
| `durationSec` | `90` |
| `transcript` | the whole transcript as one string |
| `segments` | `[{ "start": 0.32, "dur": 3, "text": "This camera allows you to see sound in" }]` (seconds) |
| `captionLanguage`, `isAutoGenerated` | `en`, `true` for YouTube's speech-recognition captions |
| `hasCaptions` | `true`, `false` (the Short has no captions) or `null` (the lookup failed) |
| `isNew` | with a monitor: `true` if no earlier run returned this Short; `null` without a monitor |
| `input` | the channel or Shorts link the row came from |
| `scrapedAt`, `error` | time of the lookup; why a row has no transcript, otherwise `null` |

### How to get the transcripts of a channel's YouTube Shorts

1. Click **Try for free**.
2. Add channels to **Channels**: `@mkbhd`, `https://www.youtube.com/@NASA` or a `UC...` channel ID. Or paste individual links into **Shorts URLs or video IDs**.
3. Set **Max Shorts per channel** (default 50). The newest Shorts come first.
4. Optional: set **Preferred caption language** (`en`, `es`, `de`...). Without it you get each Short's original language.
5. Click **Start**, then download the results as **JSON, CSV, Excel or HTML**, or read them through the API.

#### Monitor a channel for new Shorts

Turn on **Only new Shorts** and schedule the same input (daily or weekly). The first run returns the recent Shorts; every later run returns and charges only Shorts that earlier runs did not return. Give the monitor a **Monitor name** to keep its memory when you add or remove channels (a name without **Only new Shorts** only fills the `isNew` column; every Short is still returned and charged). Shorts already returned are skipped for free. A Short that has no captions yet is checked again for 48 hours, because YouTube often adds automatic captions a few hours after upload.

#### Call it from the API

```bash
curl -X POST "https://api.apify.com/v2/acts/tenfoldfleet~youtube-shorts-transcript-by-channel/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channels": ["@mkbhd"], "maxShortsPerChannel": 20}'
```

### How much does it cost to scrape YouTube Shorts transcripts?

You pay per Short returned with a transcript: **$4 per 1,000 transcripts** ($0.004 each), plus $0.00005 per run start. Proxy costs are included.

These rows are **free**:

- Shorts without captions (music only, no speech, or captions turned off), and Shorts whose captions hold only sound labels such as `[Music]`
- Shorts a new-only monitor already returned
- Lookups YouTube blocked after all retries
- Channels that do not exist or have no Shorts, and invalid links
- Links of videos longer than a Short (over about 3 minutes): this Actor reads Shorts only

On the Apify free plan the price is the same and comes out of your free monthly credit; there is no other limit. Set a max cost per run and the Actor stops there.

### Input

```json
{
    "channels": ["@mkbhd", "https://www.youtube.com/@NASA"],
    "shortsUrls": ["https://www.youtube.com/shorts/CEJXqm2eiJ0"],
    "maxShortsPerChannel": 50,
    "onlyNew": false,
    "monitorName": "",
    "language": "",
    "includeSegments": true
}
```

### Output

```json
{
    "input": "@mkbhd",
    "channel": "Marques Brownlee",
    "channelId": "UCBJycsmduvYEL83R_U4JriQ",
    "videoId": "ai1gIWacf0I",
    "url": "https://www.youtube.com/shorts/ai1gIWacf0I",
    "title": "This can SEE Sound!",
    "publishedAt": "2026-10-27",
    "views": 2758266,
    "likes": 77374,
    "durationSec": 90,
    "transcript": "This camera allows you to see sound in real time and it's honestly mind-blowing. ...",
    "segments": [
        { "start": 0.32, "dur": 3, "text": "This camera allows you to see sound in" },
        { "start": 2.12, "dur": 2.6, "text": "real time and it's honestly" }
    ],
    "captionLanguage": "en",
    "isAutoGenerated": true,
    "hasCaptions": true,
    "isNew": null,
    "scrapedAt": "2026-11-16T22:25:49.558Z",
    "error": null
}
```

A Short without captions comes back as a free row with `hasCaptions: false`, `transcript: null` and an `error` text. Download everything as JSON, CSV, Excel or HTML.

### Tips

- **Filter the free rows out** with `error = null` if you only want transcripts.
- **Large runs**: a run reads roughly 90 Shorts a minute (100 Shorts took 66 seconds in our test). With the default 1-hour run timeout that is about 5,000 Shorts; for more, raise the timeout in the run options. Shortly before the timeout the Actor stops cleanly and tells you how many Shorts it did not read.
- Turn off **Include timed segments** when you only need the text: rows get much smaller.
- The same Short found through a channel and a link is returned (and charged) once.
- `likes` or `publishedAt` can be `null` on a few rows when YouTube does not send them; the transcript is still complete.
- Transcripts come from the captions YouTube publishes (the creator's own or automatic ones). Shorts with only music have none, and this Actor does not transcribe audio itself.

### Use it with AI agents (MCP)

Give Claude, ChatGPT, Cursor or any MCP client this Actor as a tool through Apify's MCP server: add `https://mcp.apify.com?tools=tenfoldfleet/youtube-shorts-transcript-by-channel` as a remote MCP server and sign in with your Apify account. The agent fills in the input, runs the Actor and reads the transcripts itself; you pay the same per-event price as a normal run.

### FAQ

#### Can I get the transcripts of all Shorts of a channel at once?

Yes. Put the channel's @handle in **Channels** and raise **Max Shorts per channel** to as many as you need (up to 5,000). Every Short with captions comes back as one row.

#### Does it work for long YouTube videos?

No, this Actor reads Shorts only: a channel's Shorts tab, or links of single Shorts. A link of a longer video comes back as a free row without a transcript. For long videos use [YouTube Captions Downloader](https://apify.com/tenfoldfleet/youtube-transcript-scraper) with the video links.

#### Why does a Short have no transcript?

YouTube has no captions for it: it is music only, has no speech, the creator turned captions off, or it was uploaded minutes ago and automatic captions are not ready. These rows are free.

#### Which language do I get?

The Short's original language by default. Set **Preferred caption language** to get, for example, the English track when the creator published one.

#### Do I need a YouTube API key or account?

No. The Actor reads public YouTube data without a login, cookies or API quota.

#### Where is the monitor memory kept?

In a key-value store named `youtube-shorts-transcript-monitors` in your own Apify account, one record per monitor. Delete a record to start that monitor again from scratch.

### Disclaimer

This Actor collects only publicly available data from YouTube. You are responsible for how you use the transcripts, including copyright and YouTube's terms. It is not affiliated with, endorsed by or sponsored by YouTube or Google.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [YouTube Livestream & Channel Scraper - Videos, Likes & Stats](https://apify.com/tenfoldfleet/youtube-channel-scraper) | video |
| [YouTube Shorts Analytics Scraper - Views, Likes & Hashtags](https://apify.com/tenfoldfleet/youtube-shorts-scraper) | short |
| [YouTube Transcript Downloader - Captions, Subtitles & Timing](https://apify.com/tenfoldfleet/youtube-transcript-scraper) | transcript |
| [YouTube Channel Email Scraper - Creator Contact Extractor](https://apify.com/tenfoldfleet/youtube-channel-email-scraper) | channel with email |
| [YouTube Comments API & Scraper - Replies, Likes & Newest First](https://apify.com/tenfoldfleet/youtube-comments-scraper) | comment |
| [YouTube Rank Checker - Keyword Positions for Videos & Channels](https://apify.com/tenfoldfleet/youtube-rank-checker) | keyword check |
| [YouTube Search Scraper: Keyword Video & Shorts Monitor](https://apify.com/tenfoldfleet/youtube-search-scraper) | search result |
| [YouTube Video Details Lookup: Views, Likes & Tags by URL](https://apify.com/tenfoldfleet/youtube-video-details-lookup) | video details |
| [Bilibili Transcript - Video to Text with SRT & Translation](https://apify.com/tenfoldfleet/bilibili-transcript-video-to-text) | video transcript |
| [Facebook Ads Transcript - Spoken Hook, CTA, Offer & Angle](https://apify.com/tenfoldfleet/facebook-ads-transcript) | video ad transcript |
| [Facebook Reels Transcript - Facebook Video to Text, No Login](https://apify.com/tenfoldfleet/facebook-reels-transcript) | reel transcript |
| [Instagram Profile Transcript Monitor - New Reels to Text](https://apify.com/tenfoldfleet/instagram-profile-transcript-monitor) | new reel transcript |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/youtube-shorts-transcript-by-channel/changelog.md

# Actor input Schema

## `channels` (type: `array`):

YouTube channels whose Shorts you want as text: @handles (@mkbhd), channel URLs (https://www.youtube.com/@NASA) or channel IDs (UC...). The newest Shorts come first. One transcript row per Short. On the Apify free plan you pay per transcript from your free monthly credit; there is no other limit.

## `shortsUrls` (type: `array`):

Optional. Individual Shorts to read, as URLs (https://www.youtube.com/shorts/VIDEO_ID) or 11-character video IDs. Use this with or instead of channels. Shorts only: a longer video comes back as a free row without a transcript.

## `maxShortsPerChannel` (type: `integer`):

How many of the newest Shorts of each channel to read. In new-only mode this is how far back each run looks.

## `language` (type: `string`):

Language code such as en, es or de. If a Short has captions in this language you get them; otherwise you get its original-language captions. Leave empty for the original language.

## `includeSegments` (type: `boolean`):

Add the caption lines with start time and duration in seconds. Turn off to get only the full transcript text.

## `onlyNew` (type: `boolean`):

Return and charge only Shorts that earlier runs of this monitor did not return. Schedule the same input daily or weekly to get the transcript of each new Short once. Shorts already returned are skipped for free.

## `monitorName` (type: `string`):

Optional name for the new-only memory, for example competitors-tech. Runs with the same name share one memory. Without a name the memory is tied to the exact list of channels. A name alone only fills the isNew column: turn on Only new Shorts to skip (and not pay for) Shorts already returned.

## `proxyConfiguration` (type: `object`):

Proxy for channel pages. The default Apify datacenter proxy works. Residential retries for blocked calls are built in and included in the price.

## Actor input object example

```json
{
  "channels": [
    "@mkbhd"
  ],
  "maxShortsPerChannel": 10,
  "includeSegments": true,
  "onlyNew": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "channels": [
        "@mkbhd"
    ],
    "maxShortsPerChannel": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/youtube-shorts-transcript-by-channel").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "channels": ["@mkbhd"],
    "maxShortsPerChannel": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/youtube-shorts-transcript-by-channel").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "channels": [
    "@mkbhd"
  ],
  "maxShortsPerChannel": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call tenfoldfleet/youtube-shorts-transcript-by-channel --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/youtube-shorts-transcript-by-channel"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/CLqOtqZW5474bZb7y/builds/LZ4mhjv8tRC8bMA4v/openapi.json
