🎬 YouTube Downloader CC API

A simple and easy-to-use Node.js package that allows you to download YouTube videos as MP3 or MP4 and updated in March 21 2025. Built and maintained by Jonell Magallanes.

🔗 Admin: Jonell Magallanes

📥 Installation

First, install the package using npm:

npm install youtube-downloader-cc-api

This will automatically install all required dependencies.

✨ Features

✅ Download YouTube videos as MP3 (audio) or MP4 (video)
✅ Choose between two response types:

"stream" → Returns a JSON response with a download link
"direct" → Automatically downloads the file locally
✅ Fast and simple API for developers

🚀 How to Use

1️⃣ Import the Library

Before using the downloader, you need to import the function:

const { getDownloadDetails } = require("youtube-downloader-cc-api");

2️⃣ Fetch Download Details

Now, call the function with three parameters:

YouTube URL → The video you want to download
Type → Choose "mp3" for audio or "mp4" for video
Response Type → "stream" for JSON output or "direct" to auto-download

🎧 Example: Get Download Link (Stream Response)

If you only need the download link, use the "stream" response type:

const { getDownloadDetails } = require("youtube-downloader-cc-api");

(async () => {
  try {
    const url = "https://youtu.be/Rb1HSnuR8WE"; // Replace with your YouTube link
    const type = "mp3"; // Choose "mp3" or "mp4"
    const responseType = "stream"; // Get the JSON response (link only)

    const response = await getDownloadDetails(url, type, responseType);
    console.log("Download Details:", response);
  } catch (error) {
    console.error("Error:", error.message);
  }
})();

📝 Output (Stream Response)

If responseType is "stream", the function returns a JSON object like this:

{
  "url": "https://youtu.be/Rb1HSnuR8WE",
  "download": "https://yt-downloader-ccprojects-production.up.railway.app/download/1737550613.mp3",
  "title": "Family Guy Funny Spelling",
  "response": "Time Response: Wed Jan 22 12:56:57 2025",
  "author": "Jonell Hutchin Magallanes"
}

🔹 Best for: Developers who want to display the download link to users instead of downloading the file directly.

🎥 Example: Auto-Download (Direct Response)

If you want to automatically download the video or audio file, use the "direct" response type:

const { getDownloadDetails } = require("youtube-downloader-cc-api");

(async () => {
  try {
    const url = "https://youtu.be/Rb1HSnuR8WE"; // Replace with your YouTube link
    const type = "mp4"; // Choose "mp3" or "mp4"
    const responseType = "direct"; // Auto-download the file

    const response = await getDownloadDetails(url, type, responseType);
    console.log(`✅ File saved at: ${response.path}`);
  } catch (error) {
    console.error("Error:", error.message);
  }
})();

📂 Output (Direct Download)

If responseType is "direct", the function will automatically download the file to your local machine:

Downloading [####################] 100% | 8.6MB/8.6MB bytes
✅ Download complete!
File saved at: /your/path/downloaded_file.mp4

🔹 Best for: Users who want to instantly download the video/audio without extra steps.

📜 API Reference

✅ `getDownloadDetails(url, type, responseType)`

This function fetches the download details for a given YouTube video.

Parameter	Type	Required	Description
`url`	String	Yes	The YouTube video URL.
`type`	String	Yes	Choose `"mp3"` for audio or `"mp4"` for video.
`responseType`	String	Yes	`"stream"` (get link as JSON) or `"direct"` (auto-download).

🛠️ Install Dependencies (Optional)

The required dependencies are automatically installed, but if needed, you can manually install them:

npm install axios cli-progress fs path

🎯 Example Output in Node.js

When you run the example code, you will see output like this:

For stream response type:

{
  "url": "https://youtu.be/Rb1HSnuR8WE",
  "download": "https://yt-downloader-ccprojects-production.up.railway.app/download/1737550613.mp3",
  "title": "Family Guy Funny Spelling",
  "response": "Time Response: Wed Jan 22 12:56:57 2025",
  "author": "Jonell Hutchin Magallanes"
}

For direct response type:

Downloading [####################] 100% | 8.6MB/8.6MB bytes
✅ Download complete!
File saved at: /your/path/downloaded_file.mp4

🌐 Main Server of Youtube DL

This Main Server of Youtube DL CC visit https://jonell01-youtube-dl-ccapi-hutchin.hf.space/ for more info

🎉 Conclusion

The YouTube Downloader CC API makes it easy and efficient to download YouTube videos in MP3 or MP4 format. Whether you want to get a download link or automatically save the file, this library is built to be simple and developer-friendly.

🚀 Start using it today and integrate YouTube downloads into your projects!

💬 Join Our Community

Join the Chatbot Community Group on Facebook to connect with other developers:
🔗 Chatbot Community

🎖️ Special Thanks:
💡 Salamat sa CCPRAKJIK 19 na commands ko 🤑