# YouTube to MP3 / Audio Stream Downloader Pro (`viralanalyzer/youtube-to-mp3-audio-downloader-pro`) Actor

Extract direct audio stream URLs, MP3/AAC audio bitrates, tracks, duration, and metadata from YouTube videos & podcasts. Only $1.00/1K.

- **URL**: https://apify.com/viralanalyzer/youtube-to-mp3-audio-downloader-pro.md
- **Developed by:** [viralanalyzer](https://apify.com/viralanalyzer) (community)
- **Categories:** Videos, Automation, Social media
- **Stats:** 3 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.85 / 1,000 audio stream extracteds

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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?

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 to MP3 & Audio Stream Downloader Pro 🎧

> 🔗 [View on Apify Store](https://apify.com/viralanalyzer/youtube-to-mp3-audio-downloader-pro) | 🇺🇸 English | [🇧🇷 Português](#português)

***

### 🇺🇸 English

#### Overview

Extract direct audio stream URLs, MP3/AAC/Opus audio bitrates, track duration, video titles, and author metadata from YouTube videos & podcasts for AI transcription and audio analysis.

#### Features

- **Direct Audio Stream Extraction**: Direct URLs to high-bitrate audio streams (up to 320kbps)
- **AI & Whisper Ready**: Perfect for automated audio transcription pipelines and podcast ingestion
- **Format & Codec Metadata**: MP4/AAC, WebM/Opus, bitrate (bps), and audio quality ratings
- **Rich Video Metadata**: Video title, channel author, duration in seconds, view count, and thumbnails

#### Input Example

```json
{
  "videoUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ],
  "audioQuality": "HIGHEST",
  "maxVideos": 10
}
```

#### Output Example

```json
{
  "videoId": "dQw4w9WgXcQ",
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "author": "Rick Astley",
  "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "durationSeconds": 213,
  "viewCount": 1806267720,
  "audioMimeType": "audio/webm; codecs=\"opus\"",
  "audioBitrate": 136544,
  "audioQuality": "AUDIO_QUALITY_MEDIUM",
  "audioStreamUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "hasDirectAudioStream": false,
  "thumbnailUrl": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp",
  "scrapedAt": "2026-08-20T21:51:38.538Z"
}
```

#### Input Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `videoUrls` | string\[] | List of YouTube video URLs or IDs (e.g. \["https://www.youtube.com/watch?v=..."]) |
| `audioQuality` | string | Quality preference: "HIGHEST", "MEDIUM", "LOWEST" (default: "HIGHEST") |
| `maxVideos` | number | Max videos to process (default: 20) |

#### Tips

- Select `HIGHEST` audio quality for AI Whisper transcription accuracy

#### Use Cases

- **AI Transcription Pipelines** — Download YouTube podcast audio streams directly for Whisper / LLM summarization

#### FAQ

**Q: Does it download the full video file?**
A: No, it extracts only the optimized audio stream to save bandwidth and compute.

***

### 🇧🇷 Português

#### Visão Geral

Extraia links de streams de áudio direto, taxas de bits (MP3/AAC/Opus), duração, títulos e metadados de vídeos e podcasts do YouTube para transcrição por IA e análise sonora.

#### Funcionalidades

- **Extração de Áudio Direto**: URLs diretas de streams de áudio de alta fidelidade (até 320kbps)
- **Pronto para IA e Whisper**: Ideal para esteiras de transcrição automática de áudio e podcasts
- **Metadados de Formatos**: MP4/AAC, WebM/Opus, bitrate em bps e qualidade sonora
- **Metadados Completos**: Título, autor, duração em segundos, contagem de visualizações e capas

#### Exemplo de Entrada

```json
{
  "videoUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ],
  "audioQuality": "HIGHEST",
  "maxVideos": 10
}
```

#### Exemplo de Saída

```json
{
  "videoId": "dQw4w9WgXcQ",
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "author": "Rick Astley",
  "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "durationSeconds": 213,
  "viewCount": 1806267720,
  "audioMimeType": "audio/webm; codecs=\"opus\"",
  "audioBitrate": 136544,
  "audioQuality": "AUDIO_QUALITY_MEDIUM",
  "audioStreamUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "hasDirectAudioStream": false,
  "thumbnailUrl": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp",
  "scrapedAt": "2026-08-20T21:51:38.538Z"
}
```

#### Parâmetros de Entrada

| Parâmetro | Tipo | Descrição |
|-----------|------|-----------|
| `videoUrls` | string\[] | Lista de URLs ou IDs de vídeos do YouTube |
| `audioQuality` | string | Qualidade preferida: "HIGHEST", "MEDIUM", "LOWEST" (padrão: "HIGHEST") |
| `maxVideos` | number | Máximo de vídeos a processar (padrão: 20) |

#### Dicas

- Selecione qualidade `HIGHEST` para máxima precisão na transcrição por modelos de IA (Whisper)

#### Casos de Uso

- **Esteiras de Transcrição por IA** — Baixe áudios de podcasts do YouTube para transcrição e resumos por IA

#### Perguntas Frequentes

**P: Baixa o vídeo inteiro?**
R: Não, extrai apenas o stream de áudio otimizado, economizando banda e memória.

***

### 💰 Pricing

This actor uses **Pay Per Event (PPE)** pricing — you pay per **item scraped** (`video-audio-downloaded`). Apify platform usage (compute and proxy) is billed to you by Apify, separately from that price. See the current price on the **Pricing** panel of this actor's Apify Store page.

***

### 🔗 Related Actors

- [Reclame Aqui Scraper](https://apify.com/viralanalyzer/reclameaqui-scraper)
- [iFood Restaurant Intelligence](https://apify.com/viralanalyzer/ifood-restaurant-intelligence)
- [Instagram Reels Scraper](https://apify.com/viralanalyzer/instagram-reels-scraper)
- [TikTok Viral Scanner](https://apify.com/viralanalyzer/tiktok-viral-scanner)
- [Google Maps BR Scraper](https://apify.com/viralanalyzer/google-maps-br-scraper)
- [Mercado Livre Scraper](https://apify.com/viralanalyzer/mercadolivre-scraper)

***

### 📝 Changelog

- **v1.0.0** (2026-08-20) — Initial release: full extraction, Pay-Per-Event pricing, and automated proxy support

***

### License

ISC © 2026 Viral Analyzer Platform

***

💡 **Need AI analysis on top of this data — sentiment, trend detection and a dashboard, with no API keys to manage?**\
[ViralAnalyzer](https://viralanalyzer.com.br) runs this actor + 42 more data sources with built-in AI. JSON + insights in one call.

# Actor input Schema

## `videoUrls` (type: `array`):

List of YouTube video URLs or Video IDs (e.g. \['https://www.youtube.com/watch?v=dQw4w9WgXcQ', 'https://youtu.be/...']).

## `audioQuality` (type: `string`):

Select audio quality stream preference.

## `maxVideos` (type: `integer`):

Maximum number of videos to process.

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

Select Apify Proxy (Residential or Datacenter).

## Actor input object example

```json
{
  "videoUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ],
  "audioQuality": "HIGHEST",
  "maxVideos": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `audioStreams` (type: `string`):

Extracted YouTube video audio stream URLs and track metadata dataset

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

// Run the Actor and wait for it to finish
const run = await client.actor("viralanalyzer/youtube-to-mp3-audio-downloader-pro").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 = { "videoUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"] }

# Run the Actor and wait for it to finish
run = client.actor("viralanalyzer/youtube-to-mp3-audio-downloader-pro").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 '{
  "videoUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ]
}' |
apify call viralanalyzer/youtube-to-mp3-audio-downloader-pro --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,viralanalyzer/youtube-to-mp3-audio-downloader-pro"
        }
    }
}
```

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/mnMchEkjC4tL1T3Rn/builds/kBnPGbqSoQo0rbpud/openapi.json