gifted-dls 0.5.0 → 1.2.8

package/README.md

@@ -0,0 +1,398 @@
+<h3 align="center">
+  
+  <p align="center"><img src="https://img.shields.io/badge/GIFTED API & TOOLS-purple?colorA=%23ff0000&colorB=%23017e40&style=flat-square">  
+  
+</h3>
+
+### Gifted-Dls: Social Media(Youtube, Tiktok, Facebook, Instagram, Twitter) Downloader and other Api Tools
+
+- Contact **[Owner](https://api.giftedtech.my.id/contact)**
+
+  <a href="https://www.npmjs.com/package/gifted-dls"><img alt="version" src="https://img.shields.io/npm/v/gifted-dls.svg?style=flat-square"></a>
+<a href="https://www.npmjs.com/package/gifted-dls"><img src="https://img.shields.io/npm/dm/gifted-dls.svg?style=flat-square" alt="npm downloads"></a>
+[![js dilvr](https://data.jsdelivr.com/v1/package/npm/gifted-dls/badge)](https://www.jsdelivr.com/package/npm/gifted-dls)
+
+
+
+### Installation:
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+npm i gifted-dls
+```
+
+```js
+npm uninstall gifted-dls
+```
+</details>
+
+This Npm Package is Based on **[Gifted-Api](https://api.giftedtech.my.id)**
+
+### Before we start: 
+
+- You can check out my **[Free Youtube Downloader Web](https://ytdl.giftedtech.my.id)**
+- **Join [WHATSAPP CHANNEL](https://whatsapp.com/channel/0029VaYauR9ISTkHTj4xvi1l) for Daily Updates.**
+- **Check out my [Web Profile](https://giftedtech.my.id) for More Projects.**
+
+
+
+### For Esm(mjs):
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+const gifted = await import('gifted-dls'); // This is how I mostly use it in my esm projects....
+const sampleUrl = 'https://youtu.be/wJnBTPUQS5A?si=klI0qxyOnnbcriOk'; 
+let data = await gifted.default.giftedytmp3(sampleUrl)
+console.log(data)
+
+
+// OR
+
+import pkg from 'gifted-dls';
+const gifted = pkg;
+const sampleUrl = 'https://youtu.be/wJnBTPUQS5A?si=klI0qxyOnnbcriOk'; 
+let data = await gifted.giftedytmp3(sampleUrl)
+console.log(data)
+
+```
+</details>
+
+For Cjs Example Usage Startss Below...
+
+
+
+### Youtube Mp3(YtMp3):
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://www.youtube.com/watch?v=qHDJSRlNhVs'; 
+let data = await gifted.giftedytmp3(sampleUrl)
+console.log(data)
+```
+```
+{
+  status: 200,
+  creator: 'GiftedTech',
+  result: {
+    quality: '128kbps',
+    title: 'Alan Walker - The Spectre (Lyrics)',
+    thumbnail: 'https://i.ytimg.com/vi/qHDJSRlNhVs/hq720.jpg',
+    download_url: 'https://cdn-555.saveservall.xyz/tunnel?id=OsKDnDaebuLlGJAItOFhs&exp=1730712571761&sig=hOQ1uP-00zYMhkWbC2g5PoAzjBBEi7oArGwppT27wUo&sec=BlrC664d82NjJGGfmKX4GPZMjYo147u7mzH5JkvBvj8&iv=el6eD3N6l0a9gUp8BFFkmA'
+  }
+}
+```
+
+</details>
+
+
+
+### Youtube Mp4(YtMp4):
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://www.youtube.com/watch?v=qHDJSRlNhVs'; 
+let data = await gifted.giftedytmp4(sampleUrl)
+console.log(data)
+```
+```
+{
+  status: 200,
+  creator: 'GiftedTech',
+  result: {
+    quality: '480p',
+    title: 'Alan Walker - The Spectre (Lyrics) (480p).mp4',
+    thumbnail: 'https://i.ytimg.com/vi/qHDJSRlNhVs/hq720.jpg',
+    download_url: 'https://rafael3.oceansaver.in/pacific/?6qP4ny08Ui5rCDV3L2DVN8E'
+  }
+}
+```
+
+</details>
+
+
+
+### Youtube Audio(Yta):
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://youtu.be/wJnBTPUQS5A?si=klI0qxyOnnbcriOk'; 
+let data = await gifted.giftedyta(sampleUrl)
+console.log(data)
+```
+```
+{
+  status: 200,
+  creator: 'GiftedTech',
+  result: {
+    quality: '128Kbps',
+    title: 'Alan Walker - The Spectre (Lyrics) (128Kbps).mp3',
+    thumbnail: 'https://i.ytimg.com/vi/qHDJSRlNhVs/hq720.jpg',
+    download_url: 'https://st1.ezmp3.cc/download?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlUGF0aCI6Ii4vZmlsZXMvMjAyNC83LzEyLzIvMzcvZGVmZjRhMDNjYTc0NjhhNTFmM2M1NjA4Lm1wMyIsInRpdGxlIjoiQWxhbiBXYWxrZXIgLSBUaGUgU3BlY3RyZSAoTHlyaWNzKSBbIGV6bXAzLmNjIF0ubXAzIiwiaWF0IjoxNzMwNzEyNDgzLCJleHAiOjE3MzA3OTg4ODN9.ggiewjYQrnZfQ1rAbxMIq8n3lzm6kNKQ7fWD0K7bJOc?download'
+  }
+}
+```
+
+</details>
+
+
+    
+### Youtube Video(Ytv):
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://youtu.be/wJnBTPUQS5A?si=klI0qxyOnnbcriOk'; 
+let data = await gifted.giftedytv(sampleUrl)
+console.log(data)
+```
+```
+{
+  status: 200,
+  creator: 'GiftedTech',
+  result: {
+    quality: '720p-HD',
+    title: 'Alan Walker - The Spectre (Lyrics)',
+    thumbnail: 'https://i.ytimg.com/vi/qHDJSRlNhVs/hq720.jpg',
+    download_url: 'https://cdn-555.saveservall.xyz/tunnel?id=U6KX6F7_8mxdLzx5QV2YW&exp=1730712571678&sig=cPCm3b2X_KrAvmVNudAQz-l6raq2l33vNbFm5fzvFyQ&sec=p0V6u1mgXNiLiWyo0REi37kJPZnvdEgQL_VfmV07Zik&iv=1ifihfP2OOpJo4dk27DZXA'
+  }
+}
+```
+
+</details>
+
+
+
+### Youtube Audio(Request With Custom Quality):
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://www.youtube.com/watch?v=qHDJSRlNhVs';
+// const validqualities = ["64", "128", "192", "256", "320"];
+let data = await gifted.giftedytaudio(sampleUrl, quality="320")
+console.log(data)
+```
+```
+{
+  status: 200,
+  creator: 'GiftedTech',
+  result: {
+    quality: '320Kbps',
+    title: 'Alan Walker - The Spectre (Lyrics) (320Kbps).mp3',
+    thumbnail: 'https://i.ytimg.com/vi/qHDJSRlNhVs/hq720.jpg',
+    download_url: 'https://st1.ezmp3.cc/download?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlUGF0aCI6Ii4vZmlsZXMvMjAyNC83LzI0LzQvMjYvNWJhOTFjYjg3ZTg1Zjc1YjAzNWY1NDkxLm1wMyIsInRpdGxlIjoiQWxhbiBXYWxrZXIgLSBUaGUgU3BlY3RyZSAoTHlyaWNzKSBbIGV6bXAzLmNjIF0ubXAzIiwiaWF0IjoxNzMwNzE0ODg0LCJleHAiOjE3MzA4MDEyODR9.B0vPxRjqcYWRKfEjoWAZeu25jp9B-Ty0OzB215eH8uY?download'
+  }
+}
+```
+
+</details>
+
+
+
+### Youtube Video(Request With Custom Quality):
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://www.youtube.com/watch?v=qHDJSRlNhVs';
+// const validResolutions = ["360", "480", "720", "1080", "1440"];
+let data = await gifted.giftedytvideo(sampleUrl, quality="1080")
+console.log(data)
+```
+
+```
+{
+  status: 200,
+  creator: 'GiftedTech',
+  result: {
+    quality: '1080p',
+    title: 'Alan Walker - The Spectre (Lyrics) (1080p).mp4',
+    thumbnail: 'https://i.ytimg.com/vi/qHDJSRlNhVs/hq720.jpg',
+    download_url: 'https://phyllis74.oceansaver.in/pacific/?GUKx4zQOGfSv7poMSqJBJyC'
+  }
+}
+```
+
+</details>
+
+
+
+### Tiktokdl:
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://vm.tiktok.com/ZMFMun818/'; 
+let data = await gifted.giftedtiktok(sampleUrl)
+console.log(data)
+```
+```
+{
+  status: 200,
+  creator: 'GiftedTech',
+  result: {
+    type: 'video',
+    desc: '#viralvideo #kenyantiktok🇰🇪 #fypシ゚ #rockyhunter254',
+    author: {
+      avatar: 'https://tikcdn.io/ssstik/a/aHR0cHM6Ly9wMTYtYW1kLXZhLnRpa3Rva2Nkbi5jb20vdG9zLW1hbGl2YS1hdnQtMDA2OC8wNjJhMjc3NzQ5OTM5OGVhNzRiZjZmOGNhYjZkOGUwMn50cGx2LXRpa3Rva3gtY3JvcGNlbnRlci1xOjEwMDoxMDA6cTc1LndlYnA/bm9uY2U9NzQ5NTEmcHM9OTUmcmVmcmVzaF90b2tlbj01NzEwZjk5NTY0ZjZhNDNkYTQzNDVlYzVjZDIzZWUyNCZzPUFXRU1FX0RFVEFJTCZzYz1hdmF0YXImc2hjcD0xZDFhOTdmYyZzaHA9NDUxMjYyMTcmdD00Ng==',
+      nickname: 'rockyhunter254'
+    },
+    statistics: { likeCount: '72', commentCount: '6', shareCount: '1' },
+    video: 'https://tikcdn.io/ssstik/7402345886585474309',
+    music: 'https://tikcdn.io/ssstik/aHR0cHM6Ly9zZjE2LWllcy1tdXNpYy12YS50aWt0b2tjZG4uY29tL29iai9tdXNpY2FsbHktbWFsaXZhLW9iai83NDAyMzQ1OTA3OTk5MzEyNjQ1Lm1wMw=='
+  }
+}
+```
+
+</details>
+
+
+
+### Instagram Dl:
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://www.instagram.com/reel/C9bjQfRprHK/?img_index=we.are.messi'; 
+let data = await gifted.giftedigdl(sampleUrl)    
+console.log(data)
+```
+```
+{
+  creator: 'GiftedTech',
+  status: 200,
+  result: {
+    thumbnail: 'https://d.rapidcdn.app/d?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1cmwiOiJodHRwczovL3Njb250ZW50LmNkbmluc3RhZ3JhbS5jb20vdi90NTEuMjkzNTAtMTUvNDUxMTU4MjExXzkxMzU2ODEzNzAxNTk0OV80NDAzNDYwNjIxNzQ0MDQxODYzX24uanBnP3N0cD1kc3QtanBnX2UxNSZfbmNfaHQ9c2NvbnRlbnQuY2RuaW5zdGFncmFtLmNvbSZfbmNfY2F0PTEwNSZfbmNfb2hjPTVSYUhyUFRRRXJRUTdrTnZnR1UyZV9BJl9uY19naWQ9ZTc1Mzc0MjM3ZTMxNDc0NWFmMDg0NDMyMjk0M2M4OWUmZWRtPUFQczE3Q1VCQUFBQSZjY2I9Ny01Jm9oPTAwX0FZQ1ZXb3ltbzFCM3d3ZjI4M1FmU1BMZ3VEMVFPYlZwWUprSHp5QmpzcTE2Yncmb2U9NjcyRTZBNjAmX25jX3NpZD0xMGQxM2IiLCJmaWxlbmFtZSI6IlNuYXBzYXZlLmFwcF80NTExNTgyMTFfOTEzNTY4MTM3MDE1OTQ5XzQ0MDM0NjA2MjE3NDQwNDE4NjNfbi5qcGcifQ.nT0aDZrDD4p582k2wwnOG6nkDQAqwsKfRNpUofj3qL0',
+    download_url: 'https://d.rapidcdn.app/d?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1cmwiOiJodHRwczovL3Njb250ZW50LmNkbmluc3RhZ3JhbS5jb20vbzEvdi90MTYvZjEvbTg2L0VGNDBFNjRGMDFENkY0ODY0RThDM0Q4NkI0MzBDRjlBX3ZpZGVvX2Rhc2hpbml0Lm1wND9zdHA9ZHN0LW1wNCZlZmc9ZXlKeFpWOW5jbTkxY0hNaU9pSmJYQ0pwWjE5M1pXSmZaR1ZzYVhabGNubGZkblJ6WDI5MFpsd2lYU0lzSW5abGJtTnZaR1ZmZEdGbklqb2lkblJ6WDNadlpGOTFjbXhuWlc0dVkyeHBjSE11WXpJdU56SXdMbUpoYzJWc2FXNWxJbjAmX25jX2NhdD0xMDgmdnM9NDk2ODQ3Mjc5NTI5MTU5XzMwNTIzMzA5NzcmX25jX3ZzPUhCa3NGUUlZVW1sblgzaHdkbDl5WldWc2MxOXdaWEp0WVc1bGJuUmZjM0pmY0hKdlpDOUZSalF3UlRZMFJqQXhSRFpHTkRnMk5FVTRRek5FT0RaQ05ETXdRMFk1UVY5MmFXUmxiMTlrWVhOb2FXNXBkQzV0Y0RRVkFBTElBUUFWQWhnNmNHRnpjM1JvY205MVoyaGZaWFpsY25OMGIzSmxMMGREYWpVMWVHOXlSRzVMZERkM1VVUkJRVmd4TlRGUWNETnhXbGRpY1Y5RlFVRkJSaFVDQXNnQkFDZ0FHQUFiQUJVQUFDYjZyOG1wNm9yUVFCVUNLQUpETXl3WFFFWkFBQUFBQUFBWUVtUmhjMmhmWW1GelpXeHBibVZmTVY5Mk1SRUFkZjRIQUElM0QlM0QmY2NiPTktNCZvaD0wMF9BWUFVUzlnbkR5TXU2VnVkdGQ4V3VYc1g3RHQxcm42bDZRSkJoQWZNbXBVaVFnJm9lPTY3MkE1MENFJl9uY19zaWQ9MTBkMTNiIiwiZmlsZW5hbWUiOiJTbmFwc2F2ZS5hcHBfRUY0MEU2NEYwMUQ2RjQ4NjRFOEMzRDg2QjQzMENGOUFfdmlkZW9fZGFzaGluaXQubXA0In0.gQH21JSMn6Ytakfsnj5Du43Qw-KQbDJAv-pKg8Dty3A&dl=1'
+  }
+}
+```
+
+</details>
+
+
+
+
+### Facebook Dl:
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://fb.watch/gcqqhaEaEP/'; 
+let data = await gifted.giftedfbdl(sampleUrl)
+console.log(data)
+```
+```
+{
+  status: 200,
+  creator: 'GiftedTech',
+  result: {
+    hd_video: 'https://video-sin11-2.xx.fbcdn.net/o1/v/t2/f2/m69/AQPRi2mY8ZV7TxUMAnK9DOHoa6g7QwCvJCv0sCuUpxYRKEnnj69h4iNaYdPGXgPlBNcmX5xIltxd--8YwzKoUmuU.mp4?efg=eyJ4cHZfYXNzZXRfaWQiOjgzODg5ODc1MTczMjE2MCwidmVuY29kZV90YWciOiJ4cHZfcHJvZ3Jlc3NpdmUuRkFDRUJPT0suLkMzLjcyMC5kYXNoX2gyNjQtYmFzaWMtZ2VuMl83MjBwIn0&_nc_ht=video-sin11-2.xx.fbcdn.net&_nc_cat=109&strext=1&vs=b4269b545286f6f1&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HUEpVRlJ1MmplNWF6Z01EQU5vRlZHQjljb2czYm1kakFBQUYVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dKci1GQnVRT2wyYnRMUURBSnhKWGxmRm9QOWtickZxQUFBRhUCAsgBACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJoDny-Gqvv0CFQIoAkMzLBdAS0hysCDEnBgZZGFzaF9oMjY0LWJhc2ljLWdlbjJfNzIwcBEAdQIA&ccb=9-4&oh=00_AYBiMlVBMhi0CbOhdkblacdcQaBVB6sTzt7g-Kb4uWysAQ&oe=672A4B6C&_nc_sid=1d576d&dl=1',
+    sd_video: 'https://video-sin6-3.xx.fbcdn.net/o1/v/t2/f2/m69/AQNEIn1_IljG5Oztf9_TP11O9kYdLqSmmk4QxGGkpE0x0WdS7kBVtHauLxJagFchqe4mPFoR4bVhoyer1AjyNP8F.mp4?strext=1&_nc_cat=106&_nc_sid=8bf8fe&_nc_ht=video-sin6-3.xx.fbcdn.net&_nc_ohc=esSJXFnaTvgQ7kNvgE6lRbj&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6ODM4ODk4NzUxNzMyMTYwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=9-4&_nc_zt=28&oh=00_AYDK5MqudW--mJbDsoN-c0lVoxehvjkW5AMjbwdRPBHNvg&oe=672E6BF5&dl=1'
+  }
+}
+```
+
+</details>
+
+
+
+
+### Twitter Dl:
+
+<details>
+<summary>Tap to Open</summary>
+  
+```js
+// const gifted = await import('gifted-dls');
+const gifted = require('gifted-dls');
+const sampleUrl = 'https://twitter.com/i/status/1578737162757242881'; 
+let data = await gifted.giftedtwitter(sampleUrl)
+console.log(data)
+```
+```
+{
+  status: 200,
+  creator: 'GiftedTech',
+  title: 'Download video',
+  results: [
+    { text: 'Download    HD 1280x720', url: '#' },
+    {
+      text: 'Download    640x360',
+      url: 'https://ssscdn.io/ssstwitter/aHR0cHM6Ly92aWRlby50d2ltZy5jb20vZXh0X3R3X3ZpZGVvLzE2NjU3ODkwMzM0OTcxMDAyOTEvcHUvdmlkLzY0MHgzNjAvQkJnMUFtNGtrd1c1QjEyZi5tcDQ/dGFnPTEy'
+    },
+    {
+      text: 'Download    480x270',
+      url: 'https://ssscdn.io/ssstwitter/aHR0cHM6Ly92aWRlby50d2ltZy5jb20vZXh0X3R3X3ZpZGVvLzE2NjU3ODkwMzM0OTcxMDAyOTEvcHUvdmlkLzQ4MHgyNzAvSXpuemRlUUxRQkxSeHdoUi5tcDQ/dGFnPTEy'
+    }
+  ]
+}
+```
+
+</details>
+
+
+
+### Other Available Active Api Tools (console.log the data to see response structure):
+
+<details>
+<summary>Tap to Open</summary>
+
+- gifted.giftedGdriveDl
+- gifted.giftedigStalk
+- gifted.giftedttstalk
+- gifted.giftedxvideosSearch
+- gifted.giftedxvideosdl
+- gifted.giftednxnnSearch
+- gifted.giftedxnxxdl
+- gifted.giftedssweb(buffer)
+- gifted.giftedssphone(buffer)
+- gifted.giftedsstab(buffer)
+- gifted.giftedsspc(buffer)
+- gifted.giftedttp
+- gifted.giftedgoogleImage
+- gifted.giftedwallpaper
+- gifted.giftedlyrics
+- gifted.giftedscsearch
+- gifted.giftedsoundcloudDl
+- gifted.giftedsoundcloudDl2
+- gifted.giftednpmstalk
+- gifted.giftedphSearch
+- gifted.giftedspotifySearch
+- gifted.giftedspotifydl
+  
+</details>