socialmediadl

socialmediadl

A universal social media downloader package for Node.js.
Download media from 17+ platforms including LinkedIn, Threads, Reddit, Facebook, Instagram, TikTok, YouTube, Pinterest, Twitter, and more — with auto-detection and easy-to-use API.

⭐ Star History

✨ Features

• Auto-Detection: Automatically detects platform from URL
• 17+ Platforms Supported:
  • Bluesky
  • CapCut
  • Dailymotion
  • Douyin
  • Facebook & Instagram
  • Kuaishou
  • LinkedIn
  • Pinterest
  • Reddit
  • Snapchat
  • Soundcloud
  • Spotify
  • Threads
  • TikTok
  • Tumblr
  • Twitter (X)
  • YouTube
• Smart Redirect Handling: Handles YouTube and other platform redirects seamlessly
• Easy Integration: Simple function-based API
• TypeScript Ready: Works seamlessly with TypeScript projects

🚀 Installation

npm install socialmediadl

Or with yarn:

yarn add socialmediadl

Or with pnpm:

pnpm add socialmediadl

📖 Usage

Basic Usage (Auto-Detection)

The easiest way to use socialmediadl is with the auto-detection feature:

const socialmediadl = require('socialmediadl');

async function downloadMedia() {
  try {
    // Auto-detect platform and download
    const url = 'https://www.youtube.com/watch?v=dQw4w9WgXcQ';
    const result = await socialmediadl.download(url);

    console.log('Platform:', result.platform); // 'youtube'
    console.log('Data:', result.data); // Media download info
  } catch (error) {
    console.error('Error:', error.message);
  }
}

downloadMedia();

Response Format:

{
  platform: 'youtube',  // Detected platform name
  data: {
    // Platform-specific media download information
    // (varies by platform)
  }
}

Platform-Specific Downloads

For more control, use platform-specific functions:

const { 
  fetchYoutubeData,
  fetchTiktokData,
  fetchMetaData,
  fetchTwitterData 
} = require('socialmediadl');

async function examples() {
  // YouTube
  const youtubeData = await fetchYoutubeData('https://youtube.com/watch?v=...');

  // TikTok
  const tiktokData = await fetchTiktokData('https://tiktok.com/@user/video/...');

  // Facebook/Instagram
  const metaData = await fetchMetaData('https://instagram.com/p/...');

  // Twitter/X
  const twitterData = await fetchTwitterData('https://twitter.com/user/status/...');
}

Error Handling

Always wrap your calls in try-catch blocks:

const socialmediadl = require('socialmediadl');

async function safeDownload(url) {
  try {
    const result = await socialmediadl.download(url);
    return result;
  } catch (error) {
    if (error.message.includes('not supported')) {
      console.error('Platform not supported:', url);
    } else {
      console.error('Download error:', error.message);
    }
    return null;
  }
}

🔗 API Reference

Main Function

socialmediadl.download(url)

Auto-detects platform and downloads media.

Parameters:

• url (string): The social media URL

Returns:

Promise<{
  platform: string,  // Detected platform name
  data: object      // Media download information
}>

Throws:

• Error if URL is missing
• Error if platform is not supported

Platform-Specific Functions

All platform functions return a Promise with platform-specific data:

Function	Platform	Example URL
fetchBlueskyData(url)	Bluesky	https://bsky.app/...
fetchCapcutData(url)	CapCut	https://capcut.com/...
fetchDailymotionData(url)	Dailymotion	https://dailymotion.com/...
fetchDouyinData(url)	Douyin	https://douyin.com/...
fetchMetaData(url)	Facebook/Instagram	https://instagram.com/p/...
fetchKuaishouData(url)	Kuaishou	https://kuaishou.com/...
fetchLinkedinData(url)	LinkedIn	https://linkedin.com/...
fetchPinterestMedia(url)	Pinterest	https://pinterest.com/pin/...
fetchRedditData(url)	Reddit	https://reddit.com/r/...
fetchSnapchatData(url)	Snapchat	https://snapchat.com/...
fetchSoundcloudData(url)	Soundcloud	https://soundcloud.com/...
fetchSpotify(url)	Spotify	https://spotify.com/track/...
fetchThreadsData(url)	Threads	https://threads.net/...
fetchTiktokData(url)	TikTok	https://tiktok.com/@user/video/...
fetchTumblrData(url)	Tumblr	https://tumblr.com/...
fetchTwitterData(url)	Twitter/X	https://twitter.com/user/status/...
fetchYoutubeData(url)	YouTube	https://youtube.com/watch?v=...

Example:

const { fetchYoutubeData } = require('socialmediadl');

const data = await fetchYoutubeData('https://youtube.com/watch?v=...');
console.log(data);

📦 Available Exports

const socialmediadl = require('socialmediadl');

// Main function
socialmediadl.download(url)

// All platform-specific functions
const {
  fetchBlueskyData,
  fetchCapcutData,
  fetchDailymotionData,
  fetchDouyinData,
  fetchMetaData,
  fetchKuaishouData,
  fetchLinkedinData,
  fetchPinterestMedia,
  fetchRedditData,
  fetchSnapchatData,
  fetchSoundcloudData,
  fetchSpotify,
  fetchThreadsData,
  fetchTiktokData,
  fetchTumblrData,
  fetchTwitterData,
  fetchYoutubeData
} = socialmediadl;

🛠️ Technical Details

• Smart URL Detection: Automatically identifies platform from URL patterns
• Enhanced Axios Configuration: Handles redirects from YouTube and other platforms
• Modular Architecture: Each platform has its own service module
• Error Handling: Comprehensive error handling with meaningful messages
• No Server Required: Pure module package, no HTTP server needed

🏗️ Project Structure

.
├── config/            # Configuration files (axios setup)
├── services/          # Platform-specific downloader functions
├── index.js           # Main module exports
├── test.js            # Example test file
├── package.json       # Package metadata
└── README.md          # Documentation

🧪 Testing

Run the included test file to see examples:

node test.js

Or create your own test:

const socialmediadl = require('socialmediadl');

async function myTest() {
  const result = await socialmediadl.download('YOUR_URL_HERE');
  console.log(result);
}

myTest();

🤝 Contributing

Contributions are welcome! Feel free to:

• Open issues for bugs or feature requests
• Submit pull requests for improvements
• Add support for new platforms

👨‍💻 Author

ST | Sheikh Tamim
GitHub: @sheikhtamimlover
Repository: socialmediadl

📝 License

This project is open source and available for use.

🌟 Show Your Support

If you find this package useful, please consider giving it a ⭐ on GitHub!