# Youtube Transcripts Scraper (`apple_yang/youtube-transcripts-scraper`) Actor

Extract spoken transcripts from Youtube video with Bilibili Transcripts Scraper. Just enter video URLs to get transcripts. Perfect for content analysis, AI pipelines, or trend research.

- **URL**: https://apify.com/apple\_yang/youtube-transcripts-scraper.md
- **Developed by:** [APISmith](https://apify.com/apple_yang) (community)
- **Categories:** AI, Social media, Videos
- **Stats:** 14 total users, 2 monthly users, 96.6% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.00 / 1,000 results

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/platform/actors/running/actors-in-store#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 Transcripts Scraper API

Turn Youtube videos into **clean, structured transcripts** with a single API call.\
Designed for developers, data teams, and AI agents who need **reliable Chinese video speech-to-text at scale**.

***

### 🧭 Overview

**Youtube Transcripts Scraper** extracts full transcripts and time-aligned segments from any public Youtube video URL.

No browser automation.\
No manual downloading.\
Just **URL in → structured transcript out**.

This API is ideal for turning long-form Chinese video content into data that machines — and humans — can actually use.

***

### 📦 What You Can Get From This API

From a single `videoUrl`, you receive:

- 📝 **Full transcript text** (auto speech-to-text)
- ⏱️ **Segment-level timestamps** for precise alignment
- 🎞️ **Video & audio URLs** (when available)
- 📊 **Rich metadata**, including:
  - Title & description
  - Author info
  - Views, likes
  - Duration & publish time

All results are returned in **structured JSON**, ready for downstream processing.

***

### 💡 Typical Use Cases

This API is commonly used for:

- 🤖 **AI Agent pipelines**
  - Video → transcript → summarization / Q\&A / embedding
- 📚 **Content analysis & research**
  - Knowledge extraction from long Youtube videos
- 🔍 **Search & indexing systems**
  - Build searchable transcript databases
- 🧠 **LLM training & fine-tuning**
  - High-quality Chinese spoken content
- 📈 **Content repurposing**
  - Turn videos into articles, notes, or highlights

***

### 💰 Cost of Usage

Simple, predictable, and cost-effective.

**Pay only for successful results — no subscriptions.**

- 💵 **$1.00 / 1,000 results**
- 🎧 Cost-effective audio-to-text (auto transcription)
- 📊 Ideal for both small tests and large-scale production

> One result = one successfully processed video transcript.

***

### 📥 Input Parameters

#### (1) Input Format

| Field    | Type   | Required | Description |
|---------|--------|----------|-------------|
| videoUrl | string | Yes | Public Youtube video URL |

#### (2) Input Example

{
"videoUrl": "https://www.youtube.com/watch?v=iwC-WvSwm1I"
}

***

### 📤 Output Parameters

#### (1) Output Format

| Field | Type | Description |
|------|------|-------------|
| url | string | Original Youtube video URL |
| videoId | string | Youtube Video ID |
| channelId | string | Youtube channelId ID |
| title | string | Video title |
| shortDescription | string | Video description |
| publishDate | number | Publish timestamp (Unix) |
| duration | number | Video duration (seconds) |
| thumbnail | string | Cover image URL |
| view | number | View count |
| like | number | Like count |
| author | string | Author nickname |
| avatarUri | string | Author avatar URL |
| videoUrl | string | Direct video URL |
| audioUrl | string | Direct audio URL |
| category | string | Video category |
| text | string | Full transcript text |
| segments | array | Timestamped transcript segments |
| errMsg | string | Error message (empty if success) |
| timestamp | string | API response time (ISO format) |

#### (2) Output Example

```json

[
  {
    "url": "https://www.youtube.com/watch?v=iwC-WvSwm1I",
    "videoId": "iwC-WvSwm1I",
    "title": "📲Vantage App -  обзор нового суперприложения!",
    "channelId": "UCeQpv1_gx2b80rnqxp8eaYQ",
    "shortDescription": "Что если трейдинг, пассивный доход, Copy Trading и карта для расходов будут в одном приложении?\n\nВ этом видео разбираю новый Vantage App — платформу, которая может серьёзно изменить рынок в 2026.\n\nРазберём:\n✅ CFD трейдинг\n✅ Earn\n✅ Copy Trading\n✅ Сравнение с конкурентами\n\nVantage  - https://vantagemarkets.onelink.me/eGEJ/kp8f7ec7\nLinkedin: @Vantage https://www.linkedin.com/company/vantagemarkets/\nINS: @vantagemarkets https://www.instagram.com/vantagemarkets\nFacebook: @Vantage https://www.facebook.com/vantagemarkets.glb\nTikTok: @vantagemarkets_global https://www.tiktok.com/@vantagemarkets_global\nYoutube: @vantagemarkets https://www.youtube.com/@vantagemarkets\nX: @vantagemkts https://x.com/vantagemkts\n▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬\n ✅Please  Subscribe   📲 Telegram channel ▶  https://t.me/+m8fVhCrOEDcwZTUy\n                                         📲 TikTok ▶ https://bit.ly/3syAq8G\n                                         📲 X ( TWITTER ) ▶ https://x.com/7RWcrypto\n▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬\n ✅For cooperation     🔊 Рlease contact us directly at email : maximus71999@gmail.com\n                                        🔊 Telegram : https://t.me/RW719 или @RW719 \n▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬        \n  ⛔ Видео создано для ознакомления и не является призывом к каким-либо действиям. Автор не  несет ответственности за любые убытки или потери, связанные с любыми продуктами или услугами, упомянутыми в видео.\n\n#RWcrypto\n#VantageAllinOne #VantageApp #TradingSimplified #VantageTrader #VantageFollower #VantageEarner #VantageSpender",
    "videoUrl": "https://rr1---sn-uhvcpax0n5-hjvk.googlevideo.com/videoplayback?expire=1778486674&ei=MjkBao-JGvubzLUPjK3_qAg&ip=172.56.75.178&id=o-ACFC2BEuwvZiHvNMtgZGOljMItV3EtNqH2wWpWTi0KZv&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1778465074%2C&mh=hj&mm=31%2C29&mn=sn-uhvcpax0n5-hjvk%2Csn-qxo7rnee&ms=au%2Crdu&mv=m&mvi=1&pl=23&rms=au%2Cau&initcwndbps=1418750&bui=AbKmrwq-BYyt2LnI0Vu6iHc2kDvpk36RvvCDKOSDG4ns8KIY73UldxOBvRknEyrjJ_Ko7TOtwkdMWDtt&spc=96Xrv-UsX_y7duEl2BIHpTEC962rv9RX_2kUbYGOj7BzcrYDHSJxU69I1ZxdI9Pp&vprv=1&svpuc=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=8581569&ratebypass=yes&dur=142.779&lmt=1777754096748740&mt=1778464608&fvip=2&fexp=51565116%2C51565681&c=ANDROID&txp=5319224&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cspc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cratebypass%2Cdur%2Clmt&sig=AHEqNM4wRgIhANTEfM9ANeFeMot-k1TVl_9aYQlBirybJb4TRgGPJw2yAiEA6oJ2O-zfFtS99J8_rerpHiyAjqHQPf6LT6XrpiZ3jaU%3D&lsparams=met%2Cmh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Crms%2Cinitcwndbps&lsig=APaTxxMwRgIhAJIlK4lJVpOGy3YMQEbjFIPqglmnPxwCJTwT_Ws8RkYRAiEAwBix6LIqmITUnfOd7TZ9WErXDMhALCeV0UbabqG0pq4%3D",
    "publishDate": 1777719143000,
    "thumbnail": "https://i.ytimg.com/vi/iwC-WvSwm1I/hq720.jpg?sqp=-oaymwEhCK4FEIIDSFryq4qpAxMIARUAAAAAGAElAADIQj0AgKJD&rs=AOn4CLA7ZeI6tQdGa8jfKYGEH9KVTSMgmA",
    "author": "RW Crypto Insights | Trading, Analysis, Web3",
    "viewCount": 15964,
    "likeCount": 586,
    "duration": 143,
    "category": "Entertainment",
    "avatarUri": "https://yt3.ggpht.com/M30-wuVKwcZta2TRrioAllsk1xYSxvkWc5cXMDcEYZFEsPU27i5Dl_hs_s5EtZoOYPPTSQX0=s176-c-k-c0x00ffffff-no-rj",
    "errMsg": "",
    "audioUrl": "https://rr1---sn-uhvcpax0n5-hjvk.googlevideo.com/videoplayback?expire=1778486674&ei=MjkBao-JGvubzLUPjK3_qAg&ip=172.56.75.178&id=o-ACFC2BEuwvZiHvNMtgZGOljMItV3EtNqH2wWpWTi0KZv&itag=140&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1778465074%2C&mh=hj&mm=31%2C29&mn=sn-uhvcpax0n5-hjvk%2Csn-qxo7rnee&ms=au%2Crdu&mv=m&mvi=1&pl=23&rms=au%2Cau&initcwndbps=1418750&bui=AbKmrwqonIyWeWQJTyVk5NPBaxZICT1baAj3vKpXBsmSmklQvLOXiyc8iGMm1jfXCqMXMr77k_Pd-vSh&spc=96Xrv-UvX_y7duEl2BIHpTEC962qv9RX_2kUbYGOj7BzcrYDHSJxU6940HRd8w&vprv=1&svpuc=1&xtags=acont%3Doriginal%3Alang%3Dru&mime=audio%2Fmp4&rqh=1&gir=yes&clen=2312132&dur=142.779&lmt=1777755835705990&mt=1778464608&fvip=2&keepalive=yes&fexp=51565116%2C51565681&c=ANDROID&txp=5308224&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cspc%2Cvprv%2Csvpuc%2Cxtags%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AHEqNM4wRgIhAIYyphGjPGIxvgWpdcLNi2Nw4NWyuayuAdYWCupzcZhvAiEA6VWOzPNzLxpus0N6eGb8wPddPVlXGjTcmu7xuXE6V-Y%3D&lsparams=met%2Cmh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Crms%2Cinitcwndbps&lsig=APaTxxMwRgIhAJIlK4lJVpOGy3YMQEbjFIPqglmnPxwCJTwT_Ws8RkYRAiEAwBix6LIqmITUnfOd7TZ9WErXDMhALCeV0UbabqG0pq4%3D",
    "segments": [
      {
        "start": 2.159,
        "end": 5.68,
        "text": "Хватит разбрасывать свои деньги по"
      },
      {
        "start": 3.679,
        "end": 7.759,
        "text": "десяткам различных приложений. Одно для"
      },
      {
        "start": 5.68,
        "end": 11.04,
        "text": "крипты, одно для графиков, одно для"
      },
	  ...
    ],
    "text": "Хватит разбрасывать свои деньги по десяткам различных приложений. Одно для крипты, одно для графиков, одно для акций. Хватит это делать. В 2026 году это просто потеря времени и денег. И сегодня я вам расскажу, как работает настоящая экосистема. И мы разберём с вами One Up. Это единый центр, где вы торгуете, копируете профи и заставляете свои активы работать на полном пассиве. никакого хаоса, только одна кнопка для управления всем вашим капиталом. И давайте разберёмся, почему это меняет правила игры. Нage - это не новичок, это глобальный игрок с пятнадцатилетней историей. Пока другие только обещают, ...",
    "timestamp": "2026-05-11T02:04:34.926Z"
  }
]

```

***

### 🚀 Why This API Is Different

Most transcript tools stop at “just text”.\
This one is built for **real production workflows**.

- ⚙️ **Developer-first JSON structure**
- 🧩 **Segment-level timestamps**, not just plain text
- 🤖 **AI-agent ready** — perfect for chaining with LLMs
- 📈 **Built for scale**, not manual use
- 💰 **Pay-per-result pricing**, no wasted cost

You get **data**, not screenshots or scraped HTML.

***

### 📝 Notes

- Only **public Youtube video URLs** are supported
- Transcripts are generated via **automatic speech recognition**
- Accuracy may vary depending on audio quality, accents, and background noise
- This API focuses on **URL-based extraction only** (no search mode)
- Free users can only try video transcription with a duration of no more than **5 minutes**, while paid users are not limited by the duration.

***

### 🧑‍💻 Support

Need help, feature suggestions, or enterprise usage?

📧 **Email:** support@apismith.online

# Actor input Schema

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

The URL of the youtube video you want to get the data from.

## Actor input object example

```json
{
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
```

# 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 = {
    "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
};

// Run the Actor and wait for it to finish
const run = await client.actor("apple_yang/youtube-transcripts-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 = { "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

# Run the Actor and wait for it to finish
run = client.actor("apple_yang/youtube-transcripts-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 '{
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}' |
apify call apple_yang/youtube-transcripts-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=apple_yang/youtube-transcripts-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/E59vc3VSkhjITPDcg/builds/NKpYO8zRInxRzCp9D/openapi.json
