<h1 align="center">Sex.com API</h1>
<div align="center">
<a href="https://pepy.tech/project/sex_api"><img src="https://static.pepy.tech/badge/sex_api" alt="Downloads"></a>
<a href="https://github.com/EchterAlsFake/sex_api/workflows/"><img src="https://github.com/EchterAlsFake/sex_api/workflows/CodeQL/badge.svg" alt="CodeQL Analysis"/></a>
<a href="https://github.com/EchterAlsFake/sex_api/workflows/"><img src="https://github.com/EchterAlsFake/sex_api/actions/workflows/tests.yml/badge.svg" alt="API Tests"/></a>
</div>
# Description
Sex API is a Python API dedicated to Sex.com/pins. It allows you to download Pins, fetch information about Pins, Users and Boards.
You can also perform a search with filters.
> [!IMPORTANT]
> The Sex API is in violation of the Terms of Services of Sex.com. Usage is on your own risk!
> This API is related to sex.com/pins. This API does NOT support downloading videos from Sex.com nor video clips from sex.com/pins.
> The Videos are DRM locked, and the video clips need Javascript to be loaded.
# Quickstart
### Have a look at the [Documentation](https://github.com/EchterAlsFake/API_Docs/blob/master/Porn_APIs/Sex_API.md) for more details
- Install the library with `pip install sex_api`
- Or with: `pip install git+https://github.com/EchterAlsFake/sex_api` for the latest fixes / features
```python
from sex_api.api import Client
client = Client()
# Fetch a Pin
pin = client.get_pin("<URL>")
pin.download("<PATH (Directory)>")
# Print some attributes:
print(pin.name)
print(pin.publish_date) # See Docs for more
# Fetch a User:
user = client.get_user("URL")
# Get users Pins:
pins = user.get_pins()
pins_liked = user.get_liked_pins()
for pin in pins:
pin.download("<path>")
# .......
# The features are nearly endless. See Documentation for more :)
```
> [!NOTE]
> Sex API can also be run from the command line. Just execute: "sex_api -h" to get started.
# Changelog
See [Changelog](https://github.com/EchterAlsFake/sex_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 also welcome.
# License
Licensed under the LGPLv3 License
<br>Copyright (C) 2023–2025 Johannes Habel
Raw data
{
"_id": null,
"home_page": "https://github.com/EchterAlsFake/Sex_API",
"name": "Sex-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/6d/f4/2e8d6fadba911cf5e60e35ba984a6008493c72875f9c0884249d2b799b5e/sex_api-1.3.1.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">Sex.com API</h1> \n\n<div align=\"center\">\n <a href=\"https://pepy.tech/project/sex_api\"><img src=\"https://static.pepy.tech/badge/sex_api\" alt=\"Downloads\"></a>\n <a href=\"https://github.com/EchterAlsFake/sex_api/workflows/\"><img src=\"https://github.com/EchterAlsFake/sex_api/workflows/CodeQL/badge.svg\" alt=\"CodeQL Analysis\"/></a>\n <a href=\"https://github.com/EchterAlsFake/sex_api/workflows/\"><img src=\"https://github.com/EchterAlsFake/sex_api/actions/workflows/tests.yml/badge.svg\" alt=\"API Tests\"/></a>\n</div>\n\n# Description\nSex API is a Python API dedicated to Sex.com/pins. It allows you to download Pins, fetch information about Pins, Users and Boards.\nYou can also perform a search with filters.\n\n> [!IMPORTANT]\n> The Sex API is in violation of the Terms of Services of Sex.com. Usage is on your own risk!\n> This API is related to sex.com/pins. This API does NOT support downloading videos from Sex.com nor video clips from sex.com/pins.\n> The Videos are DRM locked, and the video clips need Javascript to be loaded.\n\n\n# Quickstart\n### Have a look at the [Documentation](https://github.com/EchterAlsFake/API_Docs/blob/master/Porn_APIs/Sex_API.md) for more details\n\n- Install the library with `pip install sex_api`\n- Or with: `pip install git+https://github.com/EchterAlsFake/sex_api` for the latest fixes / features\n\n```python\nfrom sex_api.api import Client\n\nclient = Client()\n\n# Fetch a Pin\npin = client.get_pin(\"<URL>\")\npin.download(\"<PATH (Directory)>\")\n\n# Print some attributes:\nprint(pin.name)\nprint(pin.publish_date) # See Docs for more\n\n# Fetch a User:\nuser = client.get_user(\"URL\")\n\n# Get users Pins:\npins = user.get_pins()\npins_liked = user.get_liked_pins()\n\nfor pin in pins:\n pin.download(\"<path>\")\n # ....... \n \n# The features are nearly endless. See Documentation for more :)\n```\n\n> [!NOTE]\n> Sex API can also be run from the command line. Just execute: \"sex_api -h\" to get started.\n\n# Changelog\nSee [Changelog](https://github.com/EchterAlsFake/sex_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 also 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 Sex.com/pins",
"version": "1.3.1",
"project_urls": {
"Homepage": "https://github.com/EchterAlsFake/Sex_API"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ef13a8aceed3b3cee3437ee75ac043a5e43c69edd0a946c435d5e215f09f5d01",
"md5": "6097b187208fe843705f3028887aae0c",
"sha256": "b094efae09644f03f4ac7a7cb4fcfe29af176da5cdafa6853575a2365f1fbbc0"
},
"downloads": -1,
"filename": "Sex_API-1.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6097b187208fe843705f3028887aae0c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 12373,
"upload_time": "2025-01-03T13:19:10",
"upload_time_iso_8601": "2025-01-03T13:19:10.878743Z",
"url": "https://files.pythonhosted.org/packages/ef/13/a8aceed3b3cee3437ee75ac043a5e43c69edd0a946c435d5e215f09f5d01/Sex_API-1.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6df42e8d6fadba911cf5e60e35ba984a6008493c72875f9c0884249d2b799b5e",
"md5": "c531cce3a313056716b336a98f1f2522",
"sha256": "2083105142a137ee640c8f5c6160fa750e38aaaee40350a731987180598f8f46"
},
"downloads": -1,
"filename": "sex_api-1.3.1.tar.gz",
"has_sig": false,
"md5_digest": "c531cce3a313056716b336a98f1f2522",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9893,
"upload_time": "2025-01-03T13:19:13",
"upload_time_iso_8601": "2025-01-03T13:19:13.578269Z",
"url": "https://files.pythonhosted.org/packages/6d/f4/2e8d6fadba911cf5e60e35ba984a6008493c72875f9c0884249d2b799b5e/sex_api-1.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-03 13:19:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "EchterAlsFake",
"github_project": "Sex_API",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sex-api"
}
JSON
