# 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:** 58 total users, 3 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 '' with your token const client = new ApifyClient({ 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 '' with your token. client = ApifyClient("") # 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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=easyapi/youtube-transcript-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Youtube Transcript Scraper", "description": "Extract YouTube video transcripts and captions effortlessly using multiple transcript services. Perfect for content analysis, subtitles extraction, and video accessibility.", "version": "0.0", "x-build-id": "ZkGecxx2BFdL0CaDO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/easyapi~youtube-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-easyapi-youtube-transcript-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/easyapi~youtube-transcript-scraper/runs": { "post": { "operationId": "runs-sync-easyapi-youtube-transcript-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/easyapi~youtube-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-easyapi-youtube-transcript-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "videoId": { "title": "YouTube Video ID", "type": "string", "description": "11-character YouTube video ID", "default": "hql6k88BKP8" }, "videoUrl": { "title": "YouTube Video URL", "type": "string", "description": "Full YouTube video URL", "default": "" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```