🚀 PrimeSave Social Downloader

A powerful, lightweight Node.js package designed to fetch direct download links for videos, audio, and images from various social media platforms. No complex configurations or API keys are required for basic usage.

✨ Supported Platforms

Extract high-quality media with ease:

• YouTube: Download Video (up to 720p) and Audio (320kbps MP3).
• TikTok: Fetch HD videos without watermarks and original background music.
• Instagram: Support for Reels and Timeline posts.
• Facebook: Extraction of both HD and SD video qualities.
• Pinterest: Download high-resolution images and MP4 videos.

🛠 Installation

Install the package using npm:

npm install primesave-dl

🚀 Quick Start

​Pass a supported social media URL to the function. It returns a Promise containing the media metadata and download options.

​CommonJS Usage:

const downloader = require('primesave-dl');

const url = '[https://www.tiktok.com/@user/video/1234567890](https://www.tiktok.com/@user/video/1234567890)';

downloader(url)
    .then(data => {
        if (data.success) {
            console.log('Platform:', data.platform);
            console.log('Title:', data.title);
            console.log('Links:', data.options);
        } else {
            console.error('Error:', data.error);
        }
    })
    .catch(err => console.error('Request Failed:', err));

Async/Await Usage:

async function getMedia() {
    try {
        const result = await downloader('[https://www.instagram.com/reels/xyz123/](https://www.instagram.com/reels/xyz123/)');
        console.log(result);
    } catch (error) {
        console.error('An unexpected error occurred:', error);
    }
}

getMedia();

📦 API Response Structure ​The package returns a standardized JSON object, making it easy to integrate into bots or web applications:

{
  "success": true,
  "platform": "TikTok",
  "title": "Summer Vibes 2026",
  "thumbnail": "[https://link-to-thumbnail.com/image.jpg](https://link-to-thumbnail.com/image.jpg)",
  "options": [
    {
      "quality": "No Watermark (HD)",
      "url": "[https://direct-video-link.mp4](https://direct-video-link.mp4)",
      "type": "Video"
    },
    {
      "quality": "Audio (MP3)",
      "url": "[https://direct-audio-link.mp3](https://direct-audio-link.mp3)",
      "type": "Audio"
    }
  ]
}

🔧 Requirements ​Node.js: 14.x or higher. ​Internet: An active connection is required to fetch data from social platforms.

​🤝 Contributing ​Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. ​Fork the Project ​Create your Feature Branch (git checkout -b feature/AmazingFeature) ​Commit your Changes (git commit -m 'Add some AmazingFeature') ​Push to the Branch (git push origin feature/AmazingFeature) ​Open a Pull Request

​📜 License ​Distributed under the MIT License. See LICENSE for more information. ​Developed by Keshara Liyanaarachchi