btch-downloader

A lightweight Python client SDK for downloading videos, images, and audio from Instagram, TikTok, YouTube, Capcut, Pinterest, Twitter, X, Google Drive, MediaFire, Douyin, SnackVideo, Xiaohongshu, Xiaohongshu Profile, Cocofun, Spotify, Youtube Search, SoundCloud, Threads, Kuaishou and Facebook.

Installation

Python Installation

Install the SDK using pip:

pip install btch-downloader

Prerequisites

Python 3.8 or higher
Required dependencies: httpx
Full Documentation Official documentation.

Usage

Basic Usage

The SDK provides asynchronous functions to download content from supported platforms.

import asyncio
from btch_downloader import ttdl, igdl, spotify, yts

async def main():
    # TikTok Downloader
    tiktok_result = await ttdl("https://www.tiktok.com/@omagadsus/video/7025456384175017243")
    print("TikTok:", tiktok_result)

    # Spotify Downloader
    spotify_result = await spotify("https://open.spotify.com/track/3zakx7RAwdkUQlOoQ7SJRt")
    print("Spotify:", spotify_result)
    
    # YouTube Search
    yts_result = await yts("movie title 2023")
    print("YouTube Search:", yts_result)

asyncio.run(main())

Supported Platforms and Example URLs

Function	Platform	Example URL / Query
`ttdl`	TikTok	`https://www.tiktok.com/@omagadsus/video/7025456384175017243`
`igdl`	Instagram	`https://www.instagram.com/reel/DKPtUL_S9Nh/?igsh=MTE1dTVkb2E4NTFmcw==`
`fbdown`	Facebook	`https://www.facebook.com/netflix/videos/1393572814172251/`
`twitter`	Twitter/X	`https://twitter.com/gofoodindonesia/status/1229369819511709697`
`youtube`	YouTube	`https://youtu.be/C8mJ8943X80`
`capcut`	Capcut	`https://www.capcut.com/template-detail/7299286607478181121`
`gdrive`	Google Drive	`https://drive.google.com/file/d/1thDYWcS5p5FFhzTpTev7RUv0VFnNQyZ4/view`
`pinterest`	Pinterest	`https://pin.it/4CVodSq` or query (e.g., "Zhao Lusi")
`douyin`	Douyin	`https://v.douyin.com/ikq8axJ/`
`xiaohongshu`	Xiaohongshu	`http://xhslink.com/o/21DKXV988zp`
`xiaohongshu_profile`	Xiaohongshu Profile	`https://www.xiaohongshu.com/user/profile/abc123`
`snackvideo`	SnackVideo	`https://s.snackvideo.com/p/j9jKr9dR`
`cocofun`	Cocofun	`https://www.icocofun.com/share/post/379250110809`
`spotify`	Spotify	`https://open.spotify.com/track/3zakx7RAwdkUQlOoQ7SJRt`
`soundcloud`	SoundCloud	`https://soundcloud.com/issabella-marchelina/sisa-rasa-mahalini-official-audio`
`threads`	Threads	`https://www.threads.net/@cindyyuvia/post/C_Nqx3khgkI/`
`kuaishou`	Kuaishou	`https://v.kuaishou.com/JT195ZHT`
`yts`	YT Search	`movie title 2023` (Query)
`aio`*	All-in-One	`https://www.tiktok.com/@omagadsus/video/7025456384175017243`
`mediafire`*	MediaFire	`https://www.mediafire.com/file/941xczxhn27qbby/GBWA_V12.25FF-By.SamMods-.apk/file`

*Unmaintained

Features

Download content from 19+ social media platforms.
Support for YouTube Search (yts).
Asynchronous API calls using httpx.
Simple and consistent interface across all services.

License

MIT License

Metadata

Release files for btch-downloader 6.0.38

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for btch-downloader 6.0.38
File	Size	Uploaded
btch_downloader-6.0.38.tar.gz	6.0 kB	Jun 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for btch-downloader 6.0.38
File	Interpreter	ABI	Platform	Reset
btch_downloader-6.0.38-py3-none-any.whl 6.2 kB Jun 29, 2026	Python 3	none	any	Details

Total release size: 12.2 kB

Release files / btch_downloader-6.0.38.tar.gz

Download URL	btch_downloader-6.0.38.tar.gz
Size	6.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`7514934f6a3a07b79436e6c8e71ac7a6572c6181d3764792a59eab055508070f`
BLAKE2b-256 checksum How to use checksums	`e3cba627a0076e2d5fef0b1be0da65fcb8cc39eef5944fefb0a46282af6b2388`
Upload date	Jun 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/hostinger-bot/btch-downloader-py
Publishing commit: github.com/hostinger-bot/btch-downloader-py/tree/5d3a326c4bf437b4af763868608c1d5dc173c9a6

Workflow

Publishing configuration: github.com/hostinger-bot/btch-downloader-py/blob/5d3a326c4bf437b4af763868608c1d5dc173c9a6/.github/workflows/python-publish.yml
Publishing logs: github.com/hostinger-bot/btch-downloader-py/actions/runs/28359880349/attempts/1

Artifact

Subject: btch_downloader-6.0.38.tar.gz
SHA-256 checksum: 7514934f6a3a07b79436e6c8e71ac7a6572c6181d3764792a59eab055508070f Verifying attestations

Release files / btch_downloader-6.0.38-py3-none-any.whl

Download URL	btch_downloader-6.0.38-py3-none-any.whl
Size	6.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cba561346e030016cb287e35bdfbd1169e5dbacc1c6268c4ca732de6d8bd66a1`
BLAKE2b-256 checksum How to use checksums	`0638ad0b1dd033eae507703f9370c490f0cc1a4d7e5e3dc0be7d0fdca903d577`
Upload date	Jun 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/hostinger-bot/btch-downloader-py
Publishing commit: github.com/hostinger-bot/btch-downloader-py/tree/5d3a326c4bf437b4af763868608c1d5dc173c9a6

Workflow

Publishing configuration: github.com/hostinger-bot/btch-downloader-py/blob/5d3a326c4bf437b4af763868608c1d5dc173c9a6/.github/workflows/python-publish.yml
Publishing logs: github.com/hostinger-bot/btch-downloader-py/actions/runs/28359880349/attempts/1

Artifact

Subject: btch_downloader-6.0.38-py3-none-any.whl
SHA-256 checksum: cba561346e030016cb287e35bdfbd1169e5dbacc1c6268c4ca732de6d8bd66a1 Verifying attestations