An asynchronous Python API wrapper and scraper for the Porn Site spankbang.com
Project description
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
Copyright (C) 2023–2026 Johannes Habel
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file unofficial_api_for_spankbang-2.2.2.tar.gz.
File metadata
- Download URL: unofficial_api_for_spankbang-2.2.2.tar.gz
- Upload date:
- Size: 11.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.5 {"installer":{"name":"uv","version":"0.10.5","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4eb89a6648bcf13a3ae57b3109a693e5d21e55611cce38c9e89e91fea4814300
|
|
| MD5 |
5862dd55e02b70af4ede19427fece34d
|
|
| BLAKE2b-256 |
4c1e84fb1d102b5b33298e2a2102e84d9310d4308858ce3cf4db8c328ffcc13b
|
File details
Details for the file unofficial_api_for_spankbang-2.2.2-py3-none-any.whl.
File metadata
- Download URL: unofficial_api_for_spankbang-2.2.2-py3-none-any.whl
- Upload date:
- Size: 14.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.5 {"installer":{"name":"uv","version":"0.10.5","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
967b68c07104b06c2e9fc57a61d7e2645672eefdb8e54fdfdde544cb186142c0
|
|
| MD5 |
fa43a25db1c17de8c2a02dcd99ee92de
|
|
| BLAKE2b-256 |
e01c7d5bd567b8b743f5588bcf28ef79d4972488640030e22d895c5830989ed5
|
