\n
A lightweight TypeScript/JavaScript client SDK for downloading videos, images, and audio from Instagram, TikTok, YouTube, Capcut, Pinterest, Twitter, X, Google Drive, MediaFire, Douyin, SnackVideo, Xiaohongshu (and Profile), Cocofun, Spotify, Youtube Search, SounCloud, Threads, Kuaishou and Facebook.
\n
\n\n| Service | Link | Status |\n|:-------------:|:--------------------------------------------------:|:------:|\n| Documentation | [Visit](http://btch.foo.ng/module-btch-downloader) | [](http://btch.foo.ng/module-btch-downloader) |\n| Backend | [Visit](https://backend1.tioo.eu.org/) | [](https://backend1.tioo.eu.org/) |\n| API Reference | [Visit](https://backend1.tioo.eu.org/docs/api-reference) | [](https://backend1.tioo.eu.org/docs/api-reference) |\n\n
\n\n\n## Usage\n\n### Instagram\n\n#### ESM\n```javascript\nimport { igdl } from 'btch-downloader';\n\nconst url = 'https://www.instagram.com/reel/DKPtUL_S9Nh/?igsh=MTE1dTVkb2E4NTFmcw==';\nigdl(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { igdl } = require('btch-downloader');\n\nconst url = 'https://www.instagram.com/reel/DKPtUL_S9Nh/?igsh=MTE1dTVkb2E4NTFmcw==';\nigdl(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### TikTok\n\n#### ESM\n```javascript\nimport { ttdl } from 'btch-downloader';\n\nconst url = 'https://www.tiktok.com/@omagadsus/video/7025456384175017243?is_from_webapp=1&sender_device=pc&web_id6982004129280116226';\nttdl(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { ttdl } = require('btch-downloader');\n\nconst url = 'https://www.tiktok.com/@omagadsus/video/7025456384175017243?is_from_webapp=1&sender_device=pc&web_id6982004129280116226';\nttdl(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Facebook\n\n#### ESM\n```javascript\nimport { fbdown } from 'btch-downloader';\n\nconst url = 'https://www.facebook.com/watch/?v=1393572814172251';\nfbdown(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { fbdown } = require('btch-downloader');\n\nconst url = 'https://www.facebook.com/watch/?v=1393572814172251';\nfbdown(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Twitter\n\n#### ESM\n```javascript\nimport { twitter } from 'btch-downloader';\n\nconst url = 'https://twitter.com/gofoodindonesia/status/1229369819511709697';\ntwitter(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { twitter } = require('btch-downloader');\n\nconst url = 'https://twitter.com/gofoodindonesia/status/1229369819511709697';\ntwitter(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### YouTube\n\n#### ESM\n```javascript\nimport { youtube } from 'btch-downloader';\n\nconst url = 'https://youtube.com/watch?v=C8mJ8943X80';\nyoutube(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { youtube } = require('btch-downloader');\n\nconst url = 'https://youtube.com/watch?v=C8mJ8943X80';\nyoutube(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### MediaFire (no longer maintained / 不再维护) \n\n#### ESM\n```javascript\nimport { mediafire } from 'btch-downloader';\n\nconst url = 'https://www.mediafire.com/file/941xczxhn27qbby/GBWA_V12.25FF-By.SamMods-.apk/file';\nmediafire(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { mediafire } = require('btch-downloader');\n\nconst url = 'https://www.mediafire.com/file/941xczxhn27qbby/GBWA_V12.25FF-By.SamMods-.apk/file';\nmediafire(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Capcut\n\n#### ESM\n```javascript\nimport { capcut } from 'btch-downloader';\n\nconst url = 'https://www.capcut.com/template-detail/7299286607478181121?template_id=7299286607478181121&share_token=80302b19-8026-4101-81df-2fd9a9cecb9c&enter_from=template_detail®ion=ID&language=in&platform=copy_link&is_copy_link=1';\ncapcut(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { capcut } = require('btch-downloader');\n\nconst url = 'https://www.capcut.com/template-detail/7299286607478181121?template_id=7299286607478181121&share_token=80302b19-8026-4101-81df-2fd9a9cecb9c&enter_from=template_detail®ion=ID&language=in&platform=copy_link&is_copy_link=1';\ncapcut(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Google Drive\n\n#### ESM\n```javascript\nimport { gdrive } from 'btch-downloader';\n\nconst url = 'https://drive.google.com/file/d/1thDYWcS5p5FFhzTpTev7RUv0VFnNQyZ4/view?usp=drivesdk';\ngdrive(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { gdrive } = require('btch-downloader');\n\nconst url = 'https://drive.google.com/file/d/1thDYWcS5p5FFhzTpTev7RUv0VFnNQyZ4/view?usp=drivesdk';\ngdrive(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Pinterest\n\n#### ESM\n```javascript\nimport { pinterest } from 'btch-downloader';\n\nconst url = 'https://pin.it/4CVodSq';\npinterest(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n\n// Using a search query\npinterest('Zhao Lusi')\n .then(data => console.log(data))\n .catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { pinterest } = require('btch-downloader');\n\nconst url = 'https://pin.it/4CVodSq';\npinterest(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n\n// Using a search query\npinterest('Zhao Lusi')\n .then(data => console.log(data))\n .catch(err => console.error(err)); // JSON\n```\n\n### AIO (no longer maintained / 不再维护) \n\n#### ESM\n```javascript\nimport { aio } from 'btch-downloader';\n\nconst url = 'https://vt.tiktok.com/ZSkGPK9Kj/';\naio(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { aio } = require('btch-downloader');\n\nconst url = 'https://vt.tiktok.com/ZSkGPK9Kj/';\naio(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Douyin (抖音)\n\n#### ESM\n```javascript\nimport { douyin } from 'btch-downloader';\n\nconst url = 'https://v.douyin.com/ikq8axJ/';\ndouyin(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { douyin } = require('btch-downloader');\n\nconst url = 'https://v.douyin.com/ikq8axJ/';\ndouyin(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n### Xiaohongshu (小红书)\n\n#### ESM\n```javascript\nimport { xiaohongshu } from 'btch-downloader';\n\nconst url = 'http://xhslink.com/o/21DKXV988zp';\nxiaohongshu(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { xiaohongshu } = require('btch-downloader');\n\nconst url = 'http://xhslink.com/o/21DKXV988zp';\nxiaohongshu(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Xiaohongshu Profile (小红书)\n\n#### ESM\n```javascript\nimport { xiaohongshuProfile } from 'btch-downloader';\n\nconst url = 'https://www.xiaohongshu.com/user/profile/67873204000000000803d9a5';\nxiaohongshuProfile(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { xiaohongshuProfile } = require('btch-downloader');\n\nconst url = 'https://www.xiaohongshu.com/user/profile/67873204000000000803d9a5';\nxiaohongshuProfile(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n### Snackvideo\n\n#### ESM\n```javascript\nimport { snackvideo } from 'btch-downloader';\n\nconst url = 'https://s.snackvideo.com/p/j9jKr9dR';\nsnackvideo(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { snackvideo } = require('btch-downloader');\n\nconst url = 'https://s.snackvideo.com/p/j9jKr9dR';\nsnackvideo(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Cocofun\n\n#### ESM\n```javascript\nimport { cocofun } from 'btch-downloader';\n\nconst url = 'https://www.icocofun.com/share/post/379250110809?lang=id&pkg=id&share_to=copy_link&m=81638cf44ba27b2ffa708f3410a4e6c2&d=63cd2733d8d258facd28d44fde5198d4cea826e89af7efc4238ada620140eea3&nt=1';\ncocofun(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { cocofun } = require('btch-downloader');\n\nconst url = 'https://www.icocofun.com/share/post/379250110809?lang=id&pkg=id&share_to=copy_link&m=81638cf44ba27b2ffa708f3410a4e6c2&d=63cd2733d8d258facd28d44fde5198d4cea826e89af7efc4238ada620140eea3&nt=1';\ncocofun(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Spotify\n\n#### ESM\n```javascript\nimport { spotify } from 'btch-downloader';\n\nconst url = 'https://open.spotify.com/track/3zakx7RAwdkUQlOoQ7SJRt';\nspotify(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { spotify } = require('btch-downloader');\n\nconst url = 'https://open.spotify.com/track/3zakx7RAwdkUQlOoQ7SJRt';\nspotify(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### YT Search\n\n#### ESM\n```javascript\nimport { yts } from 'btch-downloader';\n\nconst query = 'Somewhere Only We Know';\nyts(query).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { yts } = require('btch-downloader');\n\nconst query = 'Somewhere Only We Know';\nyts(query).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### SoundCloud\n\n#### ESM\n```javascript\nimport { soundcloud } from 'btch-downloader';\n\nconst url = 'https://soundcloud.com/issabella-marchelina/sisa-rasa-mahalini-official-audio?utm_source=clipboard&utm_medium=text&utm_campaign=social_sharing';\nsoundcloud(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { soundcloud } = require('btch-downloader');\n\nconst url = 'https://soundcloud.com/issabella-marchelina/sisa-rasa-mahalini-official-audio?utm_source=clipboard&utm_medium=text&utm_campaign=social_sharing';\nsoundcloud(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Threads\n\n#### ESM\n```javascript\nimport { threads } from 'btch-downloader';\n\nconst url = 'https://www.threads.com/@prm2.0/post/DUAdQcAkhRP?xmt=AQG0V_OPLTmE_5E242r6SPgYY_ofjuQxxRsZwS92_gBAKy4ctmOEbZP5cnKEibNlvn_8l-oK&slof=1';\nthreads(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n#### CJS\n```javascript\nconst { threads } = require('btch-downloader');\n\nconst url = 'https://www.threads.com/@prm2.0/post/DUAdQcAkhRP?xmt=AQG0V_OPLTmE_5E242r6SPgYY_ofjuQxxRsZwS92_gBAKy4ctmOEbZP5cnKEibNlvn_8l-oK&slof=1';\nthreads(url).then(data => console.log(data)).catch(err => console.error(err)); // JSON\n```\n\n### Kuaishou (快手)\n\n#### ESM\n```javascript\nimport { kuaishou } from 'btch-downloader';\n\nconst url = 'https://v.kuaishou.com/JT195ZHT';\nkuaishou(url).then(data => console.log(data)).catch(err => console.error(err)); //JSON\n```\n\n#### CJS\n```javascript\nconst { kuaishou } = require('btch-downloader');\n\nconst url = 'https://v.kuaishou.com/JT195ZHT';\nkuaishou(url).then(data => console.log(data)).catch(err => console.error(err)); //JSON\n```\n\n## Important Notes\n\n1. This downloader can only be used to download media that is public or accessible to the public.\n2. This application is not affiliated with or endorsed by any application.\n3. Ensure you have permission or copyright to download media before using this application.\n\n## Contribution and Issue Reporting\n\nIf you encounter any issues or wish to contribute to the development of this application, please visit our [GitHub repository](https://github.com/hostinger-bot/btch-downloader).\n\n## License\n\nbtch-downloader is licensed under the [MIT License](https://github.com/hostinger-bot/btch-downloader/blob/main/LICENSE). Please refer to the LICENSE file for more information.","readmeFilename":"README.md"}![\"Version\"](\"https://img.shields.io/npm/v/btch-downloader.svg?style=flat&color=blue\")
\n ![\"License\"](\"https://img.shields.io/badge/license-MIT-green.svg\"){kind=icon}
\n ![\"GitHub](\"https://img.shields.io/github/stars/hostinger-bot/btch-downloader?style=social\")
![\"GitHub](\"https://img.shields.io/github/forks/hostinger-bot/btch-downloader?style=social&color=green\")
![\"GitHub](\"https://img.shields.io/github/watchers/hostinger-bot/btch-downloader?style=social&color=purple\")
![\"Contributors\"](\"https://img.shields.io/github/contributors/hostinger-bot/btch-downloader?style=flat&color=blue\")
![\"Open](\"https://img.shields.io/github/issues/hostinger-bot/btch-downloader?style=flat&color=red\")
![\"Closed](\"https://img.shields.io/github/issues-closed/hostinger-bot/btch-downloader?style=flat&color=orange\")
![\"Open](\"https://img.shields.io/github/issues-pr/hostinger-bot/btch-downloader?style=flat&color=yellow\")
![\"Closed](\"https://img.shields.io/github/issues-pr-closed/hostinger-bot/btch-downloader?style=flat&color=brightgreen\")
![\"TypeScript\"](\"https://img.shields.io/badge/TypeScript-Ready-3178c6.svg?logo=typescript&logoColor=white\"){kind=icon}
\n ![\"Downloads\"](\"https://img.shields.io/npm/dm/btch-downloader?color=orange\")
![\"unpkg](\"https://img.shields.io/badge/unpkg-CDN-blue?style=flat&logo=unpkg\"){kind=icon}
![\"Release\"](\"https://github.com/hostinger-bot/btch-downloader/actions/workflows/release.yml/badge.svg\"){kind=icon}
\n ![\"autofix.ci\"](\"https://github.com/hostinger-bot/btch-downloader/actions/workflows/autofix.yml/badge.svg\"){kind=icon}
\n ![\"CodeQL](\"https://github.com/hostinger-bot/btch-downloader/actions/workflows/codeql.yml/badge.svg\"){kind=icon}
\n ![\"Donate\"](\"https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black\")
\n \n![\"npm](\"https://nodei.co/npm/btch-downloader.png?downloads=true&downloadRank=true&stars=true&data=d,s&color=blue\")
\n \n