<h1 align="center">missAV API</h1>
<div align="center">
<a href="https://pepy.tech/project/missAV_api"><img src="https://static.pepy.tech/badge/missAV_api" alt="Downloads"></a>
<a href="https://pepy.tech/project/missAV_api-async"><img src="https://static.pepy.tech/badge/missAV_api-async" alt="Downloads"></a> <span style="font-size: 20px;">(Async)</span>
<a href="https://github.com/EchterAlsFake/missAV_api/workflows/CodeQL/badge.svg" alt="CodeQL Analysis"></a>
<a href="https://github.com/EchterAlsFake/missAV_api/actions/workflows/sync-tests.yml/badge.svg"><img src="https://github.com/EchterAlsFake/missAV_api/actions/workflows/sync-tests.yml/badge.svg" alt="Sync API Tests"/></a>
<a href="https://github.com/EchterAlsFake/missAV_api/actions/workflows/async-tests.yml/badge.svg"><img src="https://github.com/EchterAlsFake/missAV_api/actions/workflows/async-tests.yml/badge.svg" alt="Async API Tests"></a>
</div>
# Description
missAV API is an API for missav.com. It allows you to download videos using HLS streaming
> [!CAUTION]
> The missav.com website has been taken down by "legal procedures." The content uploaded on similar sites such as missav.ws is probably copyright protected.
> This API is intended to allow offline usage of the content. You could also just extract the m3u8 by yourself, but it's just more time-consuming.
### I EXPLICITLY FORBID YOU TO REDISTRIBUTE CONTENT DOWNLOADED THROUGH THIS API
See: `https://avdaisukicp.com/kaizoku/index_en.html`
# Disclaimer
> [!IMPORTANT]
> missAV API is in violation to the ToS of missav.com!
> If you are the website owner of missav.com, contact me at my E-Mail, and I'll take this repository immediately offline.
> EchterAlsFake@proton.me
> [!NOTE]
> This project was developed for my **[Porn Fetch](https://github.com/EchterAlsFake/Porn_Fetch)** project to support video downloading
> from missav. Therefore, this API only has very basic and limited functionality. If you want more features, I can extend this
> API, so don't hesitate to open an issue about it :)
# Quickstart
### Have a look at the [Documentation](https://github.com/EchterAlsFake/API_Docs/blob/master/Porn_APIs/missAV.md) for more details
- Install the library with `pip install missAV_api`
```python
from missav_api import Client
# Initialize a Client object
client = Client()
# Fetch a video
video_object = client.get_video("<insert_url_here>")
# Information from Video objects
print(video_object.title)
# Download the video
video_object.download(downloader="threaded", quality="best", path="your_output_path + filename")
# SEE DOCUMENTATION FOR MORE
```
# Changelog
See [Changelog](https://github.com/EchterAlsFake/missAV_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 also welcome.
# License
Licensed under the [LGPLv3](https://www.gnu.org/licenses/lgpl-3.0.en.html) License
<br>Copyright (C) 2024-2025 Johannes Habel
Raw data
{
"_id": null,
"home_page": "https://github.com/EchterAlsFake/missAV_api",
"name": "missAV-api",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Johannes Habel",
"author_email": "EchterAlsFake@proton.me",
"download_url": "https://files.pythonhosted.org/packages/35/9c/181bdde84c34a366682201e3e63a260932e588b47a7088de182daf24ebf7/missav_api-1.4.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">missAV API</h1> \n\n<div align=\"center\">\n <a href=\"https://pepy.tech/project/missAV_api\"><img src=\"https://static.pepy.tech/badge/missAV_api\" alt=\"Downloads\"></a>\n <a href=\"https://pepy.tech/project/missAV_api-async\"><img src=\"https://static.pepy.tech/badge/missAV_api-async\" alt=\"Downloads\"></a> <span style=\"font-size: 20px;\">(Async)</span>\n <a href=\"https://github.com/EchterAlsFake/missAV_api/workflows/CodeQL/badge.svg\" alt=\"CodeQL Analysis\"></a>\n <a href=\"https://github.com/EchterAlsFake/missAV_api/actions/workflows/sync-tests.yml/badge.svg\"><img src=\"https://github.com/EchterAlsFake/missAV_api/actions/workflows/sync-tests.yml/badge.svg\" alt=\"Sync API Tests\"/></a>\n <a href=\"https://github.com/EchterAlsFake/missAV_api/actions/workflows/async-tests.yml/badge.svg\"><img src=\"https://github.com/EchterAlsFake/missAV_api/actions/workflows/async-tests.yml/badge.svg\" alt=\"Async API Tests\"></a>\n</div>\n\n# Description\nmissAV API is an API for missav.com. It allows you to download videos using HLS streaming\n\n> [!CAUTION]\n> The missav.com website has been taken down by \"legal procedures.\" The content uploaded on similar sites such as missav.ws is probably copyright protected.\n> This API is intended to allow offline usage of the content. You could also just extract the m3u8 by yourself, but it's just more time-consuming.\n\n### I EXPLICITLY FORBID YOU TO REDISTRIBUTE CONTENT DOWNLOADED THROUGH THIS API\nSee: `https://avdaisukicp.com/kaizoku/index_en.html`\n\n# Disclaimer\n> [!IMPORTANT] \n> missAV API is in violation to the ToS of missav.com!\n> If you are the website owner of missav.com, contact me at my E-Mail, and I'll take this repository immediately offline.\n> EchterAlsFake@proton.me\n\n> [!NOTE]\n> This project was developed for my **[Porn Fetch](https://github.com/EchterAlsFake/Porn_Fetch)** project to support video downloading\n> from missav. Therefore, this API only has very basic and limited functionality. If you want more features, I can extend this\n> API, so don't hesitate to open an issue about it :)\n# Quickstart\n\n### Have a look at the [Documentation](https://github.com/EchterAlsFake/API_Docs/blob/master/Porn_APIs/missAV.md) for more details\n\n- Install the library with `pip install missAV_api`\n\n\n```python\nfrom missav_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# Information from Video objects\nprint(video_object.title)\n# Download the video\n\nvideo_object.download(downloader=\"threaded\", quality=\"best\", path=\"your_output_path + filename\")\n\n# SEE DOCUMENTATION FOR MORE\n```\n\n# Changelog\nSee [Changelog](https://github.com/EchterAlsFake/missAV_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 also welcome.\n\n# License\nLicensed under the [LGPLv3](https://www.gnu.org/licenses/lgpl-3.0.en.html) License\n<br>Copyright (C) 2024-2025 Johannes Habel\n",
"bugtrack_url": null,
"license": "LGPLv3",
"summary": "A Python API for the Porn Site missav.ws",
"version": "1.4",
"project_urls": {
"Homepage": "https://github.com/EchterAlsFake/missAV_api"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c19e5f733f49e5cbd04d5c20fd472302f7746a8779a279f5092b167fe177b857",
"md5": "05fecb300befea4598939133fd55a7d7",
"sha256": "a8754824957459e44d9516119b1c5868053d3f8b31a3b3d8118a3f74929f6c1b"
},
"downloads": -1,
"filename": "missAV_api-1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "05fecb300befea4598939133fd55a7d7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5406,
"upload_time": "2025-02-05T19:23:05",
"upload_time_iso_8601": "2025-02-05T19:23:05.257527Z",
"url": "https://files.pythonhosted.org/packages/c1/9e/5f733f49e5cbd04d5c20fd472302f7746a8779a279f5092b167fe177b857/missAV_api-1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "359c181bdde84c34a366682201e3e63a260932e588b47a7088de182daf24ebf7",
"md5": "fdafd2cb54a92f3c24d5db867d1d6617",
"sha256": "7b21b53656640e08344ca63451edd5f3cd04f6772142dedbd9263a2962728928"
},
"downloads": -1,
"filename": "missav_api-1.4.tar.gz",
"has_sig": false,
"md5_digest": "fdafd2cb54a92f3c24d5db867d1d6617",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4639,
"upload_time": "2025-02-05T19:23:06",
"upload_time_iso_8601": "2025-02-05T19:23:06.246422Z",
"url": "https://files.pythonhosted.org/packages/35/9c/181bdde84c34a366682201e3e63a260932e588b47a7088de182daf24ebf7/missav_api-1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-05 19:23:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "EchterAlsFake",
"github_project": "missAV_api",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "missav-api"
}