<h1 align="center">Spankbang API</h1>
<div align="center">
<a href="https://pepy.tech/project/spankbang_api"><img src="https://static.pepy.tech/badge/spankbang_api" alt="Downloads"></a>
<a href="https://github.com/EchterAlsFake/spankbang_api/workflows/"><img src="https://github.com/EchterAlsFake/spankbang_api/workflows/CodeQL/badge.svg" alt="CodeQL Analysis"/></a>
<a href="https://github.com/EchterAlsFake/spankbang_api/workflows/"><img src="https://github.com/EchterAlsFake/spankbang_api/actions/workflows/tests.yml/badge.svg" alt="API Tests"/></a>
</div>
# 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
# Quickstart
### Have a look at the [Documentation](https://github.com/EchterAlsFake/API_Docs/blob/master/Porn_APIs/Spankbang.md) for more details
- Install the library with `pip install spankbang_api`
- Or from git using `pip install git+https://github.com/EchterAlsFake/spankbang_api`
```python
from spankbang_api import Client
# Initialize a Client object
client = Client()
# Fetch a video
video_object = 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
video_object.download(quality="best", path="your_output_path")
```
# Changelog
See [Changelog](https://github.com/EchterAlsFake/spankbang_api/blob/master/README/Changelog.md) 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–2024 Johannes Habel
Raw data
{
"_id": null,
"home_page": null,
"name": "spankbang-api",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Johannes Habel <EchterAlsFake@proton.me>",
"download_url": "https://files.pythonhosted.org/packages/67/64/8072fee78cef06fdfb33d0cb08c6984842a66e9a61ca4d5a4afe5560b15f/spankbang_api-1.9.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">Spankbang API</h1> \n\n<div align=\"center\">\n <a href=\"https://pepy.tech/project/spankbang_api\"><img src=\"https://static.pepy.tech/badge/spankbang_api\" alt=\"Downloads\"></a>\n <a href=\"https://github.com/EchterAlsFake/spankbang_api/workflows/\"><img src=\"https://github.com/EchterAlsFake/spankbang_api/workflows/CodeQL/badge.svg\" alt=\"CodeQL Analysis\"/></a>\n <a href=\"https://github.com/EchterAlsFake/spankbang_api/workflows/\"><img src=\"https://github.com/EchterAlsFake/spankbang_api/actions/workflows/tests.yml/badge.svg\" alt=\"API Tests\"/></a>\n</div>\n\n# Description\nSpankbang API is an API for Spankbang. It allows you to fetch information from videos using regexes and requests.\n\n> [!CAUTION]\n> Spankbang is very strict about rate limiting. This API will **RESPECT** all 429 errors and wait properly. Don't\n> try to bypass this and don't ask me to bypass it. I won't.\n\n# Disclaimer\n\n> [!IMPORTANT] \n> Spankbang API is in violation to Spankbang's ToS!\n> If you are the website owner of spankbang.com, contact me at my E-Mail, and I'll take this repository immediately offline.\n> EchterAlsFake@proton.me\n\n# Quickstart\n\n### Have a look at the [Documentation](https://github.com/EchterAlsFake/API_Docs/blob/master/Porn_APIs/Spankbang.md) for more details\n\n- Install the library with `pip install spankbang_api`\n- Or from git using `pip install git+https://github.com/EchterAlsFake/spankbang_api`\n\n\n```python\nfrom spankbang_api import Client\n# Initialize a Client object\nclient = Client()\n\n# Fetch a video\nvideo_object = client.get_video(\"<insert_url_here>\")\n\n# Get information from videos\nvideo_object.title\nvideo_object.rating\nvideo_object.description\n# See docs for more...\n\n# Download the video\nvideo_object.download(quality=\"best\", path=\"your_output_path\")\n\n```\n\n# Changelog\nSee [Changelog](https://github.com/EchterAlsFake/spankbang_api/blob/master/README/Changelog.md) for more details.\n\n# Contribution\nDo you see any issues or having some feature requests? Simply open an Issue or talk\nin the discussions.\n\nPull requests are welcome :) \n\n# License\nLicensed under the LGPLv3 License\n\nCopyright (C) 2023\u20132024 Johannes Habel\n\n",
"bugtrack_url": null,
"license": "LGPLv3",
"summary": "A Python API for the Porn Site spankbang.com",
"version": "1.9",
"project_urls": {
"Homepage": "https://github.com/EchterAlsFake/spankbang_api"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ac5d06e7dd6f6775649c2f7d2c4ebdccd2b6f2bb4ace54beb25b94c2cfbfcb8c",
"md5": "7e895bfe99743cfac74a074de6aff97e",
"sha256": "d1dabf957681893c97555da793375c734ae5ff7713df02cad712fffe77b2f1cd"
},
"downloads": -1,
"filename": "spankbang_api-1.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7e895bfe99743cfac74a074de6aff97e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 11707,
"upload_time": "2025-10-25T00:41:28",
"upload_time_iso_8601": "2025-10-25T00:41:28.038747Z",
"url": "https://files.pythonhosted.org/packages/ac/5d/06e7dd6f6775649c2f7d2c4ebdccd2b6f2bb4ace54beb25b94c2cfbfcb8c/spankbang_api-1.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "67648072fee78cef06fdfb33d0cb08c6984842a66e9a61ca4d5a4afe5560b15f",
"md5": "d10d2473d0769228005277ef60159f13",
"sha256": "a63b02f62734ebf2dca1d47a29a7d1d69bd24ba3de0d5ea1a06d29665d1aedab"
},
"downloads": -1,
"filename": "spankbang_api-1.9.tar.gz",
"has_sig": false,
"md5_digest": "d10d2473d0769228005277ef60159f13",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 11087,
"upload_time": "2025-10-25T00:41:29",
"upload_time_iso_8601": "2025-10-25T00:41:29.475334Z",
"url": "https://files.pythonhosted.org/packages/67/64/8072fee78cef06fdfb33d0cb08c6984842a66e9a61ca4d5a4afe5560b15f/spankbang_api-1.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-25 00:41:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "EchterAlsFake",
"github_project": "spankbang_api",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "eaf_base_api",
"specs": []
},
{
"name": "bs4",
"specs": []
},
{
"name": "beautifulsoup4",
"specs": []
},
{
"name": "lxml",
"specs": []
},
{
"name": "m3u8",
"specs": []
},
{
"name": "h2",
"specs": []
},
{
"name": "brotli",
"specs": []
},
{
"name": "av",
"specs": []
}
],
"lcname": "spankbang-api"
}
JSON
