# Youtube Transcript Scraper (`easyapi/youtube-transcript-scraper`) Actor

Extract YouTube video transcripts and captions effortlessly using multiple transcript services. Perfect for content analysis, subtitles extraction, and video accessibility.

- **URL**: https://apify.com/easyapi/youtube-transcript-scraper.md
- **Developed by:** [EasyApi](https://apify.com/easyapi) (community)
- **Categories:** AI, Automation, Integrations
- **Stats:** 60 total users, 0 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## YouTube Transcript Extractor 📝

Extract transcripts and closed captions from YouTube videos easily and efficiently. This actor supports multiple transcript services to ensure reliable results.

### Features 🌟

- Extract transcripts from any YouTube video using video URL or ID
- Support for multiple transcript services (Tactiq, NoteGPT)
- Detailed timestamp information for each caption segment
- Clean JSON output format
- Handles various YouTube URL formats automatically

### Use Cases 💡

- Content Analysis & Research
- Video Accessibility Enhancement
- Subtitle Generation
- SEO Optimization
- Educational Content Processing
- Video Content Mining

### Input Parameters ⚙️

| Parameter | Type | Description |
|-----------|------|-------------|
| videoId | String | YouTube video ID (11 characters) |
| videoUrl | String | Full YouTube video URL |

You can provide either the video ID or the complete YouTube URL. The actor will automatically extract the correct video ID.

### Output 📊

The actor outputs a JSON object containing:

- Video ID
- Service used for extraction
- Complete transcript with timestamps
- Timestamp of extraction

### Tips 💪

- For best results, ensure the video has closed captions enabled
- Processing time may vary depending on video length

### Limitations ⚠️

- Only supports YouTube videos
- Rate limits may apply based on service provider

Need help or have questions? Feel free to reach out through Apify's support channels! 🤝

#### Input Example

A full explanation of an input example in JSON.

```
{
    "videoId": "hql6k88BKP8"
}
```

#### Output sample

The results will be wrapped into a dataset which you can always find in the **Storage** tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

```json
[
	{
		"title": "Eye Doctor Explains How to Get Rid of Under EYE BAGS",
		"captions": [
			{
				"start": "0",
				"dur": "5.84",
				"text": "so a super common question I get as an eye doctor is: how to get rid of under eye bags? I bet at  "
			},
			{
				"start": "5.84",
				"dur": "4",
				"text": "some point you've looked in the mirror and saw your eyelids looking puffy and you're like,  "
			},
			{
				"start": "9.84",
				"dur": "4.24",
				"text": "Why do i have these bags under my eyes? and ultimately how do i get rid of them? and I've  "
			},
			{
				"start": "14.08",
				"dur": "5.92",
				"text": "seen a lot of BS stuff on YouTube as well as on the internet just kind of talking about ways to  "
			},
			{
				"start": "20",
				"dur": "9.84",
				"text": "remove eye bags so I wanted to shed some light on the subject that's today's video let's take a look"
			},
			{
				"start": "32.16",
				"dur": "3.44",
				"text": "hey what's up this is Dr Allen here from the Doctor Eye Health show helping you learn all  "
			},
			{
				"start": "35.6",
				"dur": "3.76",
				"text": "about the eyes vision and finding the best vision products if you're new here to the channel and  "
			},
			{
				"start": "39.36",
				"dur": "3.44",
				"text": "like learning about the eyes seeing your best then hit that subscribe button down below and  "
			},
			{
				"start": "42.8",
				"dur": "4.08",
				"text": "ring the bell so that you don't miss any of our future videos now in this video i first want to  "
			},
			{
				"start": "46.88",
				"dur": "4.24",
				"text": "go over how to get rid of eye bags naturally, as a lot of my viewers on this channel and my  "
			},
			{
				"start": "51.12",
				"dur": "4.8",
				"text": "patients in the clinic including myself we're not big fans of taking medications if we don't have to  "
			},
			{
				"start": "55.92",
				"dur": "5.76",
				"text": "but then I also want to comment on under eye bag creams and really why I don't recommend them and  "
			},
			{
				"start": "61.68",
				"dur": "4.4",
				"text": "then we'll comment on different surgical options for treatment for under eye bags  "
			},
			{
				"start": "66.08",
				"dur": "4.88",
				"text": "but first here are a few things that you can do at home tip number one is to avoid high salt  "
			},
			{
				"start": "70.96",
				"dur": "5.68",
				"text": "diets when you eat a lot of salty food that's going to cause water to accumulate in your tissues  "
			},
			{
				"start": "76.64",
				"dur": "6",
				"text": "leading to swollen puffy eyes with that under eye bag appearance it's not the true number one cause  "
			},
			{
				"start": "82.64",
				"dur": "5.04",
				"text": "for having under eye bags but it certainly causes this issue for a lot of people and  "
			},
			{
				"start": "87.68",
				"dur": "5.76",
				"text": "it will exacerbate your symptoms and this is even the same reason why people get puffy eyelids after  "
			},
			{
				"start": "93.44",
				"dur": "6",
				"text": "crying because the salt content of your tears ends up drawing water into the tissue causing swollen  "
			},
			{
				"start": "99.44",
				"dur": "5.68",
				"text": "puffy eyelids leading to those under eye bags in this case for anybody with a swollen puffy eyelid  "
			},
			{
				"start": "105.12",
				"dur": "5.52",
				"text": "use cold compresses cold compresses will help shrink the blood vessels around the eye  "
			},
			{
				"start": "110.64",
				"dur": "4.8",
				"text": "causing the eyelids to look less puffy now of course people have always seen these videos of  "
			},
			{
				"start": "115.44",
				"dur": "5.36",
				"text": "people with cucumbers on their eyes i don't think there's anything magical about the cucumber itself  "
			},
			{
				"start": "120.8",
				"dur": "4.08",
				"text": "maybe antioxidants but i don't have any real studies to base that off of  "
			},
			{
				"start": "124.88",
				"dur": "5.12",
				"text": "and it's really probably just the coolness of having a cold cucumber on the eye that's really  "
			},
			{
				"start": "130",
				"dur": "4.8",
				"text": "doing the help at home of course you can do a cold compress with an ice pack for example a  "
			},
			{
				"start": "134.8",
				"dur": "5.76",
				"text": "cold compressed mask or you can use something like a bag of peas or even do the frozen spoon trick  "
			},
			{
				"start": "140.56",
				"dur": "4.24",
				"text": "it's really not that technical you just want to get something cold to those eyelids to shrink  "
			},
			{
				"start": "144.8",
				"dur": "3.92",
				"text": "them down and then hopefully you won't have such a large appearance of those under eye bags  "
			},
			{
				"start": "148.72",
				"dur": "5.6",
				"text": "now another big issue for under eye bags is eye allergies allergies are going to cause histamine  "
			},
			{
				"start": "154.32",
				"dur": "4.32",
				"text": "to be released from your tissue that's going to cause your blood vessels and your tissues to  "
			},
			{
				"start": "158.64",
				"dur": "6.48",
				"text": "swell up become red and you'll have that itchy sensation number one do not rub your eyes when  "
			},
			{
				"start": "165.12",
				"dur": "5.36",
				"text": "you're having eye allergies it'll feel good at first but really just makes things worse two  "
			},
			{
				"start": "170.48",
				"dur": "4.56",
				"text": "using a cold compress like we just discussed should help with a lot of the symptoms and  "
			},
			{
				"start": "175.04",
				"dur": "5.52",
				"text": "bring down some of that swelling and number three there are great antihistamine eye allergy drops  "
			},
			{
				"start": "180.56",
				"dur": "5.36",
				"text": "and oral antihistamines that can help with this thankfully we have great eye allergy drops and  "
			},
			{
				"start": "185.92",
				"dur": "3.6",
				"text": "I've done a couple of videos on some of the best ones you can always look those up if you want to  "
			},
			{
				"start": "189.52",
				"dur": "4.48",
				"text": "check them out otherwise the only warning i would give out about using any oral antihistamines is  "
			},
			{
				"start": "194",
				"dur": "5.36",
				"text": "that they often do dry out your tissues and so a lot of people on those medications for allergies  "
			},
			{
				"start": "199.36",
				"dur": "5.44",
				"text": "can end up with really dry eyes so watch out for that now before we talk about under eye bag creams  "
			},
			{
				"start": "204.8",
				"dur": "3.28",
				"text": "let me know that you're getting value out of this video by smashing the like button because  "
			},
			{
				"start": "208.08",
				"dur": "3.92",
				"text": "that's going to let me know that i should keep making videos like this thanks now when it comes  "
			},
			{
				"start": "212",
				"dur": "4.48",
				"text": "to under eye bag creams there are about a million different brands out there on the market and I'm  "
			},
			{
				"start": "216.48",
				"dur": "5.6",
				"text": "honestly not a big fan of them and I'll tell you why most of these under eye bag creams such as  "
			},
			{
				"start": "222.08",
				"dur": "7.68",
				"text": "serum albumin is a lid or skin tightening cream and yes some of them do work but they're only  "
			},
			{
				"start": "229.76",
				"dur": "6.8",
				"text": "temporary as a fix they ultimately don't solve the issue and most of these different cosmetics  "
			},
			{
				"start": "236.56",
				"dur": "6",
				"text": "these creams they're not regulated and so they use preservatives which many of these preservatives  "
			},
			{
				"start": "243.12",
				"dur": "6.32",
				"text": "have been found to cause permanent damage to the oil glands in the eyelids and that can lead to not  "
			},
			{
				"start": "249.44",
				"dur": "5.6",
				"text": "only dry skin on the eyelid which again the skin is very thin and delicate and then you can end up  "
			},
			{
				"start": "255.04",
				"dur": "4.96",
				"text": "with really severe dry eye disease that's exactly why most eye doctors do not recommend using  "
			},
			{
				"start": "260",
				"dur": "6",
				"text": "retinol face creams on the eyelid because there have been studies showing that those creams can  "
			},
			{
				"start": "266",
				"dur": "5.52",
				"text": "cause permanent damage to the Meibomian glands in the eyelid leading to evaporative dry eye disease  "
			},
			{
				"start": "271.52",
				"dur": "5.36",
				"text": "so again i personally do not recommend under eye bag creams but I know if you're looking for either  "
			},
			{
				"start": "276.88",
				"dur": "5.12",
				"text": "moisturizing creams for the eyes sunblock around the eyes or even you're looking for makeup or  "
			},
			{
				"start": "282",
				"dur": "5.04",
				"text": "something on the eyes that's eye friendly this is becoming a bigger concern in eye care and so some  "
			},
			{
				"start": "287.04",
				"dur": "3.76",
				"text": "companies are researching this and coming out with products I'll try to put some links in the  "
			},
			{
				"start": "290.8",
				"dur": "3.92",
				"text": "video description below in case you're interested in just finding again something that's more eye  "
			},
			{
				"start": "294.72",
				"dur": "6.16",
				"text": "friendly now the true number one cause for under eye bags largely has to do with changes of your  "
			},
			{
				"start": "300.88",
				"dur": "7.04",
				"text": "eyelids skin and the fat around your eyes the skin of your eyelid is the thinnest skin on your  "
			},
			{
				"start": "307.92",
				"dur": "5.92",
				"text": "body and underneath the skin is a piece of tissue which when we're young is fairly rigid and holds  "
			},
			{
				"start": "313.84",
				"dur": "5.76",
				"text": "the fat behind it in place but then as you get older due to damage of the skin and this tissue  "
			},
			{
				"start": "319.6",
				"dur": "6.88",
				"text": "whether it be from sunlight or UV light exposure due to age and genetics the tissue becomes very  "
			},
			{
				"start": "326.48",
				"dur": "6.32",
				"text": "elastic which means the fat behind it starts to push and it protrudes outward leading to under  "
			},
			{
				"start": "332.8",
				"dur": "5.12",
				"text": "eye bags which makes it really tough to hear for a lot of people that this is largely due to age  "
			},
			{
				"start": "337.92",
				"dur": "6.48",
				"text": "and there's not really a miracle cure for it but because of these reasons that is why oftentimes  "
			},
			{
				"start": "344.4",
				"dur": "6.4",
				"text": "surgical correction is kind of the end-all be-all treatment for under eye bags we call this surgery  "
			},
			{
				"start": "350.8",
				"dur": "7.6",
				"text": "for having under eye bags called a lower eyelid blepharoplasty sometimes referred to as a lower  "
			},
			{
				"start": "358.4",
				"dur": "5.6",
				"text": "eyelid lift this is where your surgeon will go in underneath your eyelid and make an incision  "
			},
			{
				"start": "364",
				"dur": "5.28",
				"text": "and they'll remove some of this orbital puffy orbital fat from underneath that lower puffy  "
			},
			{
				"start": "369.28",
				"dur": "6",
				"text": "eyelid and they make the incision under the eyelid that way when it heals you don't have this obvious  "
			},
			{
				"start": "375.28",
				"dur": "5.92",
				"text": "scar on your face now of course surgery may not be for everyone but if you are thinking hey I have  "
			},
			{
				"start": "381.2",
				"dur": "4.4",
				"text": "this I just want to get it done i want to talk to a medical professional about what's going on  "
			},
			{
				"start": "385.6",
				"dur": "4.64",
				"text": "I encourage you to reach out to a local eye care professional especially one that may work with  "
			},
			{
				"start": "390.24",
				"dur": "6",
				"text": "oculoplastic surgeons who are familiar with it as well as helping you kind of coordinate your care  "
			},
			{
				"start": "396.24",
				"dur": "5.52",
				"text": "thankfully most major cities and medical centers do have an oculoplastic surgeon or just a plastic  "
			},
			{
				"start": "401.76",
				"dur": "6",
				"text": "surgeon in general who has experience doing lower lid blepharoplasties one extra tip I like to throw  "
			},
			{
				"start": "407.76",
				"dur": "5.6",
				"text": "out there is about prevention and preventing your under eye bags from getting worse I think  "
			},
			{
				"start": "413.36",
				"dur": "5.6",
				"text": "one ounce of prevention is worth a pound of treatment right so wearing UV light protecting  "
			},
			{
				"start": "418.96",
				"dur": "6.16",
				"text": "sunblock on your skin regularly when you're outside wide brim hats and sunglasses are great  "
			},
			{
				"start": "425.12",
				"dur": "5.68",
				"text": "tips to help slow down sunlight damage to your skin because the vast majority of early aging  "
			},
			{
				"start": "430.8",
				"dur": "5.44",
				"text": "and damage to your skin tissues especially the thin eyelid has to do with sunlight exposure so  "
			},
			{
				"start": "436.24",
				"dur": "3.92",
				"text": "hey I hope you enjoyed this video and I'll pass it off to you to let me know in the comment section  "
			},
			{
				"start": "440.16",
				"dur": "4.48",
				"text": "what your favorite part of the video was is there any other questions you have about under eye bags  "
			},
			{
				"start": "444.64",
				"dur": "4",
				"text": "or under eye bag treatment again let me know in the comment section otherwise thank you so  "
			},
			{
				"start": "448.64",
				"dur": "4.08",
				"text": "much for watching again if you enjoyed today's video hit that like button for me subscribe if  "
			},
			{
				"start": "452.72",
				"dur": "5.44",
				"text": "you have not done so already and if you have confusion about kind of what under eye bags  "
			},
			{
				"start": "458.16",
				"dur": "4.24",
				"text": "are versus things like dark circles I did a video on dark circles about a year ago it'd  "
			},
			{
				"start": "462.4",
				"dur": "3.12",
				"text": "probably help you out if you want to check out that video go ahead and click or tap the screen  "
			},
			{
				"start": "465.52",
				"dur": "5.6",
				"text": "up over here to the side or if you just have other questions concerns about eye care contact lenses  "
			},
			{
				"start": "471.12",
				"dur": "4.4",
				"text": "glasses surgeries like Lasik go ahead and click or tap the screen down over here again this is  "
			},
			{
				"start": "475.52",
				"dur": "4.32",
				"text": "Dr. Allen here from the Dr Eye Health show, keep an eye on it and we'll talk to you soon"
			}
		]
	}
]
```

# Actor input Schema

## `videoId` (type: `string`):

11-character YouTube video ID

## `videoUrl` (type: `string`):

Full YouTube video URL

## Actor input object example

```json
{
  "videoId": "hql6k88BKP8",
  "videoUrl": ""
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("easyapi/youtube-transcript-scraper").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("easyapi/youtube-transcript-scraper").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 '{}' |
apify call easyapi/youtube-transcript-scraper --silent --output-dataset

```

## MCP server setup

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

```

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/1G2rKXjMlX6xbQA2d/builds/ZkGecxx2BFdL0CaDO/openapi.json