# 🚀 PyBoostyAPI
**PyBoostyAPI** is a powerful asynchronous Python library for seamless interaction with [Boosty.to](https://boosty.to) through its internal API. It supports posts, subscribers, dialogs, sales, donations, and detailed statistics.
---
## ✨ Features
- 🔐 Authentication with token auto-refresh
- 📬 User dialog handling
- 📊 Fetching statistics and sales data
- 💬 Get free and paid subscribers
- 📝 Create and delete posts
- 💰 Get donation and subscription tier info
---
## ⚙️ Installation
```bash
pip install PyBoostyApi
````
Or manually:
```bash
git clone https://github.com/HOCKI1/py_boosty_api.git
cd py_boosty_api
pip install .
```
---
## 🔧 Basic Usage Example
```python
import asyncio
from boosty_api import BoostyAPI
async def main():
api = await BoostyAPI.create("auth.json")
try:
href = await api.get_blog_href()
print("🔗 Blog href:", href)
stats = await api.get_blog_stats() # Get stats of your Blog
print("📊 Stats:", stats)
finally:
await api.close()
if __name__ == "__main__":
asyncio.run(main())
```
---
## 🗂 `auth.json` Structure
```json
{
"access_token": "your_token",
"refresh_token": "your_refresh_token",
"expiresAt": 1722193100,
"_clientId": "your_uuid"
}
```
---
## 📌 TODO
* [x] Posts
* [x] Subscribers
* [ ] Dialogs
* [x] Donations
* [x] Sales
* [x] Auto token refresh
* [x] Media content (albums, images)
* [ ] More common usable functions
---
## 📄 License
This project is licensed under the **MIT License**. See `LICENSE` for details.
---
## 🤝 Contact
Author: [HOCKI1](https://github.com/HOCKI1)
Email: [hocki1.official@yandex.ru](mailto:hocki1.official@yandex.ru)
Made with ❤️ for the Boosty creator community.
Raw data
{
"_id": null,
"home_page": "https://github.com/HOCKI1/py_boosty_api",
"name": "PyBoostyApi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "boosty api async aiohttp donations subscribers",
"author": "HOCKI1",
"author_email": "hocki1.official@yandex.ru",
"download_url": "https://files.pythonhosted.org/packages/bd/d4/7e1afea4c71785be1ca9ff1cc8291c06bdbc4c5322b53fb8940e127e0b21/pyboostyapi-1.0.2.tar.gz",
"platform": null,
"description": "\n# \ud83d\ude80 PyBoostyAPI\n\n**PyBoostyAPI** is a powerful asynchronous Python library for seamless interaction with [Boosty.to](https://boosty.to) through its internal API. It supports posts, subscribers, dialogs, sales, donations, and detailed statistics.\n\n\n\n\n\n---\n\n## \u2728 Features\n\n- \ud83d\udd10 Authentication with token auto-refresh\n- \ud83d\udcec User dialog handling\n- \ud83d\udcca Fetching statistics and sales data\n- \ud83d\udcac Get free and paid subscribers\n- \ud83d\udcdd Create and delete posts\n- \ud83d\udcb0 Get donation and subscription tier info\n\n---\n\n## \u2699\ufe0f Installation\n\n```bash\npip install PyBoostyApi\n````\n\nOr manually:\n\n```bash\ngit clone https://github.com/HOCKI1/py_boosty_api.git\ncd py_boosty_api\npip install .\n```\n\n---\n\n## \ud83d\udd27 Basic Usage Example\n\n```python\nimport asyncio\nfrom boosty_api import BoostyAPI\n\nasync def main():\n api = await BoostyAPI.create(\"auth.json\")\n try:\n href = await api.get_blog_href()\n print(\"\ud83d\udd17 Blog href:\", href)\n\n stats = await api.get_blog_stats() # Get stats of your Blog\n print(\"\ud83d\udcca Stats:\", stats)\n\n finally:\n await api.close()\n\nif __name__ == \"__main__\":\n asyncio.run(main())\n\n```\n\n---\n\n## \ud83d\uddc2 `auth.json` Structure\n\n```json\n{\n \"access_token\": \"your_token\",\n \"refresh_token\": \"your_refresh_token\",\n \"expiresAt\": 1722193100,\n \"_clientId\": \"your_uuid\"\n}\n```\n\n---\n\n## \ud83d\udccc TODO\n\n* [x] Posts\n* [x] Subscribers\n* [ ] Dialogs\n* [x] Donations\n* [x] Sales\n* [x] Auto token refresh\n* [x] Media content (albums, images)\n* [ ] More common usable functions\n\n---\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the **MIT License**. See `LICENSE` for details.\n\n---\n\n## \ud83e\udd1d Contact\n\nAuthor: [HOCKI1](https://github.com/HOCKI1)\nEmail: [hocki1.official@yandex.ru](mailto:hocki1.official@yandex.ru)\nMade with \u2764\ufe0f for the Boosty creator community.\n\n",
"bugtrack_url": null,
"license": null,
"summary": "PyBoostyAPI is a powerful asynchronous Python library for seamless interaction with the Boosty.to API",
"version": "1.0.2",
"project_urls": {
"Homepage": "https://github.com/HOCKI1/py_boosty_api",
"Source": "https://github.com/HOCKI1/py_boosty_api",
"Tracker": "https://github.com/HOCKI1/py_boosty_api/issues"
},
"split_keywords": [
"boosty",
"api",
"async",
"aiohttp",
"donations",
"subscribers"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "97d218bd473f4e197b952c93c44c70e4df4b761b26c0dc1d573c86a680b2c5ef",
"md5": "b01b32529bba9b07ab836efdce29aa19",
"sha256": "cdfd2490059cae14b7265b866bd41c1954374b47947fe387b87551d3a85cd1e0"
},
"downloads": -1,
"filename": "pyboostyapi-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b01b32529bba9b07ab836efdce29aa19",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 7577,
"upload_time": "2025-07-29T14:33:44",
"upload_time_iso_8601": "2025-07-29T14:33:44.210163Z",
"url": "https://files.pythonhosted.org/packages/97/d2/18bd473f4e197b952c93c44c70e4df4b761b26c0dc1d573c86a680b2c5ef/pyboostyapi-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bdd47e1afea4c71785be1ca9ff1cc8291c06bdbc4c5322b53fb8940e127e0b21",
"md5": "c59b1d2029c50d3a4669e0d5f48466d6",
"sha256": "564678640fbfbf2ed847f0ecdcb20bc64889fdf8b199f18c390305fc762ea337"
},
"downloads": -1,
"filename": "pyboostyapi-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "c59b1d2029c50d3a4669e0d5f48466d6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 7340,
"upload_time": "2025-07-29T14:33:45",
"upload_time_iso_8601": "2025-07-29T14:33:45.436002Z",
"url": "https://files.pythonhosted.org/packages/bd/d4/7e1afea4c71785be1ca9ff1cc8291c06bdbc4c5322b53fb8940e127e0b21/pyboostyapi-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-29 14:33:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "HOCKI1",
"github_project": "py_boosty_api",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pyboostyapi"
}
JSON
