<h1 align="center">HQPorner API</h1>
<div align="center">
<a href="https://pepy.tech/project/hqporner_api"><img src="https://static.pepy.tech/badge/hqporner_api" alt="Downloads"></a>
<a href="https://pepy.tech/project/hqporner_api-async"><img src="https://static.pepy.tech/badge/hqporner_api-async" alt="Downloads"></a> <span style="font-size: 20px;">(Async)</span>
<a href="https://github.com/EchterAlsFake/hqporner_api/workflows/"><img src="https://github.com/EchterAlsFake/hqporner_api/workflows/CodeQL/badge.svg" alt="CodeQL Analysis"/></a>
<a href="https://github.com/EchterAlsFake/hqporner_api/actions/workflows/sync-tests.yml"><img src="https://github.com/EchterAlsFake/hqporner_api/actions/workflows/sync-tests.yml/badge.svg" alt="API Tests"/></a>
<a href="https://github.com/EchterAlsFake/hqporner_api/actions/workflows/async-tests.yml"><img src="https://github.com/EchterAlsFake/hqporner_api/actions/workflows/async-tests.yml/badge.svg?branch=async" alt="API Tests"/></a>
</div>
# Description
HQPorner API is an API for HQPorner. It allows you to fetch information from videos using regexes and requests.
# Disclaimer
> [!IMPORTANT]
> HQPorner API is in violation to HQporner's ToS!
> If you are the website owner of hqporner.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/HQPorner.md) for more details
- Install the library with `pip install hqporner_api`
```python
from hqporner_api import Client
# Initialize a Client object
client = Client()
# Fetch a video
video_object = client.get_video("<insert_url_here>")
# Download the video
video_object.download(quality="best", path="your_output_path + title.mp4")
# Videos by actress
actress_generator = client.get_videos_by_actress("anissa-kate")
for video in actress_generator:
print(video.title) # etc...
# Search for videos
videos = client.search_videos(query="Your query here")
for video in videos:
print(video.title)
# SEE DOCUMENTATION FOR MORE
```
> [!NOTE]
> HQPorner API can also be used from the command line. Do: hqporner_api -h to see the options
# Changelog
See [Changelog](https://github.com/EchterAlsFake/hqporner_api/blob/master/README/Changelog.md) for more details.
# Support (Donations)
I am developing all my projects entirely for free. I do that, because I have fun and I don't want
to charge 30€ like other people do.
However, if you find my work useful, please consider donating something. A tiny amount such as 1€
means a lot to me.
Paypal: https://paypal.me/EchterAlsFake
<br>XMR (Monero): `46xL2reuanxZgFxXBBaoagiEJK9c7bL7aiwKNR15neyX2wUsX2QVzkeRMVG2Cro44qLUNYvsP1BQa12KPbNat2ML41nyEeq`
# 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
<br>Copyright (C) 2023–2025 Johannes Habel
Raw data
{
"_id": null,
"home_page": "https://github.com/EchterAlsFake/hqporner_api",
"name": "hqporner-api-async",
"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/90/63/60d3faf48297fdff3a0d3ae6969d1b3a32232940e6567657b09d8ed9beb8/hqporner_api_async-1.7.3.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">HQPorner API</h1> \n\n<div align=\"center\">\n <a href=\"https://pepy.tech/project/hqporner_api\"><img src=\"https://static.pepy.tech/badge/hqporner_api\" alt=\"Downloads\"></a>\n <a href=\"https://pepy.tech/project/hqporner_api-async\"><img src=\"https://static.pepy.tech/badge/hqporner_api-async\" alt=\"Downloads\"></a> <span style=\"font-size: 20px;\">(Async)</span>\n <a href=\"https://github.com/EchterAlsFake/hqporner_api/workflows/\"><img src=\"https://github.com/EchterAlsFake/hqporner_api/workflows/CodeQL/badge.svg\" alt=\"CodeQL Analysis\"/></a>\n <a href=\"https://github.com/EchterAlsFake/hqporner_api/actions/workflows/sync-tests.yml\"><img src=\"https://github.com/EchterAlsFake/hqporner_api/actions/workflows/sync-tests.yml/badge.svg\" alt=\"API Tests\"/></a>\n <a href=\"https://github.com/EchterAlsFake/hqporner_api/actions/workflows/async-tests.yml\"><img src=\"https://github.com/EchterAlsFake/hqporner_api/actions/workflows/async-tests.yml/badge.svg?branch=async\" alt=\"API Tests\"/></a>\n</div>\n\n# Description\n\nHQPorner API is an API for HQPorner. It allows you to fetch information from videos using regexes and requests.\n\n# Disclaimer\n\n> [!IMPORTANT] \n> HQPorner API is in violation to HQporner's ToS!\n> If you are the website owner of hqporner.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/HQPorner.md) for more details\n\n- Install the library with `pip install hqporner_api`\n\n\n```python\nfrom hqporner_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# Download the video\nvideo_object.download(quality=\"best\", path=\"your_output_path + title.mp4\")\n\n# Videos by actress\nactress_generator = client.get_videos_by_actress(\"anissa-kate\")\nfor video in actress_generator:\n print(video.title) # etc...\n\n# Search for videos\nvideos = client.search_videos(query=\"Your query here\")\nfor video in videos:\n print(video.title)\n\n# SEE DOCUMENTATION FOR MORE\n```\n\n> [!NOTE]\n> HQPorner API can also be used from the command line. Do: hqporner_api -h to see the options\n\n# Changelog\nSee [Changelog](https://github.com/EchterAlsFake/hqporner_api/blob/master/README/Changelog.md) for more details.\n\n# Support (Donations)\nI am developing all my projects entirely for free. I do that, because I have fun and I don't want\nto charge 30\u20ac like other people do.\n\nHowever, if you find my work useful, please consider donating something. A tiny amount such as 1\u20ac\nmeans a lot to me.\n\nPaypal: https://paypal.me/EchterAlsFake\n<br>XMR (Monero): `46xL2reuanxZgFxXBBaoagiEJK9c7bL7aiwKNR15neyX2wUsX2QVzkeRMVG2Cro44qLUNYvsP1BQa12KPbNat2ML41nyEeq`\n\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<br>Copyright (C) 2023\u20132025 Johannes Habel\n",
"bugtrack_url": null,
"license": "LGPLv3",
"summary": "A Python API for the Porn Site HQPorner.com",
"version": "1.7.3",
"project_urls": {
"Homepage": "https://github.com/EchterAlsFake/hqporner_api"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "191f53dd594ef6abc47992b5d420457545a463068649fb2b39f90efc679c3745",
"md5": "2baf8cec8733e0154437a35b813fa26c",
"sha256": "bdb8c6409bba3b76cdf9e8a764e3c0e94607ef5eb9eea6a242590ef9f5b23ca2"
},
"downloads": -1,
"filename": "hqporner_api_async-1.7.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2baf8cec8733e0154437a35b813fa26c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 15131,
"upload_time": "2025-01-10T13:35:07",
"upload_time_iso_8601": "2025-01-10T13:35:07.573504Z",
"url": "https://files.pythonhosted.org/packages/19/1f/53dd594ef6abc47992b5d420457545a463068649fb2b39f90efc679c3745/hqporner_api_async-1.7.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "906360d3faf48297fdff3a0d3ae6969d1b3a32232940e6567657b09d8ed9beb8",
"md5": "0164cfffeefe6a0a2524779c0df8b00a",
"sha256": "f724c40817f5a2d030bea85841b2240d8bbcfd4d83f3db3c40c046d8be57b873"
},
"downloads": -1,
"filename": "hqporner_api_async-1.7.3.tar.gz",
"has_sig": false,
"md5_digest": "0164cfffeefe6a0a2524779c0df8b00a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 13431,
"upload_time": "2025-01-10T13:35:09",
"upload_time_iso_8601": "2025-01-10T13:35:09.663137Z",
"url": "https://files.pythonhosted.org/packages/90/63/60d3faf48297fdff3a0d3ae6969d1b3a32232940e6567657b09d8ed9beb8/hqporner_api_async-1.7.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-10 13:35:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "EchterAlsFake",
"github_project": "hqporner_api",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "hqporner-api-async"
}
JSON
