🎬 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:

``bash
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

$3

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

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

---

$3

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

---

$3

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

`javascript
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);
}
})();
`

$3

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

`json
{
"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.

---

$3

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

`javascript
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);
}
})();
`

$3

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

`bash
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

$3

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:

`bash
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:
`json
{
"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:
`bash
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 🤑