Spankbang API

Description

Spankbang API is an API for Spankbang. It allows you to fetch information from videos using regexes and requests.

[!CAUTION] Spankbang is very strict about rate limiting. This API will RESPECT all 429 errors and wait properly. Don't try to bypass this and don't ask me to bypass it. I won't.

Disclaimer

[!IMPORTANT] Spankbang API is in violation to Spankbang's ToS! If you are the website owner of spankbang.com, contact me at my E-Mail, and I'll take this repository immediately offline. EchterAlsFake@proton.me

Features

Fetch videos + metadata
Download videos
Fetch Channels
Fetch Pornstars
Search for videos
Asynchronous
Built-in caching
Easy interface
Great type hinting

Networking Features

HTTP 2.0 / HTTP 3.0
Browser impersonation
Custom JA3
All proxy types
Proxy authentication
Speed Limit
DNS over HTTPS
And even more...
All of this is configurable and can be adjusted as you like!

Quickstart

Have a look at the Documentation for more details

Install the library with pip install spankbang_api
Or from git using pip install git+https://github.com/EchterAlsFake/spankbang_api

from spankbang_api import Client
import asyncio
# Initialize a Client object

async def do_something():
    client = Client()
    
    # Fetch a video
    video_object = await client.get_video("<insert_url_here>")
    
    # Get information from videos
    video_object.title
    video_object.rating
    video_object.description
    # See docs for more...
    
    # Download the video
    await video_object.download(quality="best", path="your_output_path")
asyncio.run(do_something())

Changelog

See Changelog for more details.

Contribution

Do you see any issues or having some feature requests? Simply open an Issue or talk in the discussions.

Pull requests are welcome :)

License

Licensed under the LGPLv3 License

Metadata

Release files for spankbang_api 2.2.2

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

Source distribution (sdist)

Source distribution for spankbang_api 2.2.2
File	Size	Uploaded
spankbang_api-2.2.2.tar.gz	10.9 kB	Jun 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for spankbang_api 2.2.2
File	Interpreter	ABI	Platform	Reset
spankbang_api-2.2.2-py3-none-any.whl 14.4 kB Jun 23, 2026	Python 3	none	any	Details

Total release size: 25.3 kB

Release files / spankbang_api-2.2.2.tar.gz

Download URL	spankbang_api-2.2.2.tar.gz
Size	10.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`813712b324d9b75b02a46a5d64d66f50959f78b566be89e04903efd79d53c26e`
BLAKE2b-256 checksum How to use checksums	`280f997ff0e90d99a6c9ef96b61d1648b664d2500c327cfd580c376a920ac52c`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / spankbang_api-2.2.2-py3-none-any.whl

Download URL	spankbang_api-2.2.2-py3-none-any.whl
Size	14.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b8776410a6a298e96230eceb68628ad77426064dfc7e2cd5570d96b524d5bb7e`
BLAKE2b-256 checksum How to use checksums	`e227728743291350486143279c30fa37da313bd9f37d1655cc666cf0a253164e`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`