snapsave-media-downloader/README.md

Download Instagram, Facebook, TikTok and Twitter (X) media using snapsave.app downloader

# Snapsave Media Downloader

[![npm version][npm-version-src]][npm-version-href]

Download Instagram, Facebook, TikTok and Twitter (X) media using snapsave.app downloader

## Install dependency
```bash
# Using npm
npm install snapsave-media-downloader

# Using pnpm
pnpm add snapsave-media-downloader
```

Example:
```js
import { snapsave } from "snapsave-media-downloader";

const download = await snapsave("https://www.instagram.com/p/C51YHfWJwHK/");

console.log(download);
```
Output example (Instagram):
```json
{
  "success": true,
  "data": {
    "media": [
      {
        "url": "https://d.rapidcdn.app/d?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "thumbnail": "https://d.rapidcdn.app/d?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "type": "video"
      }
    ]
  }
}
```

Output example (Facebook):
```json
{
  "success": true,
  "data": {
    "description": "...",
    "preview": "https://scontent-iad3-2.xx.fbcdn.net/v/t51.29350-10/466628901_1297725364716204_4835926798887889488_n.jpg?...",
    "media": [
      {
        "resolution": "720p (HD)",
        "url": "https://d.rapidcdn.app/d?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "type": "video"
      },
      {
        "resolution": "360p (SD)",
        "url": "https://d.rapidcdn.app/d?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "type": "video"
      },
      {
        "resolution": "1080p",
        "shouldRender": true,
        "url": "https://snapsave.app/render.php?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "type": "video"
      }
    ]
  }
}
```

Output example (TikTok):
```json
{
  "success": true,
  "data": {
    "description": "Does anyone else’s cat love doing this️ #RoadTo16Million #Pubity(Andrew Kuzmic via ViralHog)",
    "preview": "https://p16-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-euttp/240d7e6a213e5cc0ef7dc69277408efc~tplv-tiktokx-cropcenter-q:720:720:q75.jpeg",
    "media": [
      {
        "url": "httpss://snapxcdn.com/v2/?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "type": "video"
      }
    ]
  }
}
```
Output example (Twitter):
```json
{
  "success": true,
  "data": {
    "description": "X description example",
    "preview": "https://pbs.twimg.com/amplify_video_thumb/1234567890123456789/img/9IPCFIfDAb7WJ2cL.jpg",
    "media": [
      {
        "url": "https://d.rapidcdn.app/v2?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
        "type": "video"
      }
    ]
  }
}
```
## Options
```js
await snapsave("https://www.instagram.com/p/C51YHfWJwHK/", {
  retry: 3,
  retryDelay: 500, // ms
  userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
  proxy: "http://proxy.example.com:8080" // Optional proxy URL
});
```

### Using Proxy
You can use a proxy server for all requests by providing the `proxy` option:

```js
import { snapsave } from "snapsave-media-downloader";

// HTTP Proxy
const result = await snapsave("https://www.tiktok.com/@user/video/1234567890", {
  proxy: "http://proxy.example.com:8080"
});

// HTTPS Proxy
const result2 = await snapsave("https://www.instagram.com/p/C51YHfWJwHK/", {
  proxy: "https://secure-proxy.example.com:8443"
});

// Proxy with authentication
const result3 = await snapsave("https://twitter.com/user/status/1234567890", {
  proxy: "http://username:password@proxy.example.com:8080"
});

// SOCKS5 Proxy
const result4 = await snapsave("https://www.facebook.com/watch/?v=1234567890", {
  proxy: "socks5://proxy.example.com:1080"
});
```

<!-- Badges -->
[npm-version-src]: https://img.shields.io/npm/v/snapsave-media-downloader.svg?style=flat
[npm-version-href]: https://npmjs.com/package/snapsave-media-downloader