# Sofascore Wrapper
A Python API wrapper for the Sofascore undocumented API. This library allows you to fetch and interact with Sofascore data, including information about matches, players, teams, and more.
[](https://pepy.tech/projects/sofascore-wrapper)
## 📖 Documentation
For detailed usage and API reference, visit the official documentation:
👉 [Sofascore Wrapper Docs](https://tommhe14.github.io/sofascore-wrapper)
## 📥 Installation
You can install the package using pip:
```bash
pip install sofascore-wrapper
```
## 🚀 Usage Example
Here's a quick example to get you started:
```python
import asyncio
from sofascore_wrapper.api import SofascoreAPI
from sofascore_wrapper.search import Search
async def main():
api = SofascoreAPI() # Initialize the API client
search = Search(api, search_string="saka")
player = await search.search_all()
print(player)
await api.close()
if __name__ == "__main__":
asyncio.run(main())
```
## 💬 Need Help?
Join our Discord community for support and discussions:
👉 [Discord Support Server](https://discord.gg/pGYmZxUKB7)
## 📜 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## From Me!
Will slowly be adding more sports along our journey! SofaScore API is written to re-use requests for multiple sports, So in theory making requests for a sport other than football (soccer) will allow you to make requests with any class (match, player, etc). Any requests for the dedicated sport that you cannot, they will be under the dedicated sport i.e Basketball.player_stats() rather than Player.stats()
- If you encounter any issues feel free to open an issue.
- If you have any enhancement requests, feel free to open an issue with the front end proof of what you're looking to get.
- Always open to pull requests!
## Examples
Check out some more use cases from the examples folder!
---
Enjoy using **Sofascore Wrapper**! 🎉
Raw data
{
"_id": null,
"home_page": "https://github.com/tommhe14/sofascore-wrapper",
"name": "sofascore-wrapper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "tommhe14",
"author_email": "theckley@yahoo.co.uk",
"download_url": "https://files.pythonhosted.org/packages/b5/16/d11a09d717ae472e73c24677f9dfb6d7918cc64a41f1d76dd75bb21f4a99/sofascore_wrapper-1.0.23.tar.gz",
"platform": null,
"description": "# Sofascore Wrapper\n\nA Python API wrapper for the Sofascore undocumented API. This library allows you to fetch and interact with Sofascore data, including information about matches, players, teams, and more.\n\n[](https://pepy.tech/projects/sofascore-wrapper)\n\n## \ud83d\udcd6 Documentation\nFor detailed usage and API reference, visit the official documentation:\n\ud83d\udc49 [Sofascore Wrapper Docs](https://tommhe14.github.io/sofascore-wrapper)\n\n## \ud83d\udce5 Installation\nYou can install the package using pip:\n```bash\npip install sofascore-wrapper\n```\n\n## \ud83d\ude80 Usage Example\nHere's a quick example to get you started:\n```python\nimport asyncio\nfrom sofascore_wrapper.api import SofascoreAPI\nfrom sofascore_wrapper.search import Search\n\nasync def main():\n api = SofascoreAPI() # Initialize the API client\n search = Search(api, search_string=\"saka\")\n player = await search.search_all()\n print(player)\n await api.close()\n\nif __name__ == \"__main__\":\n asyncio.run(main())\n```\n\n## \ud83d\udcac Need Help?\nJoin our Discord community for support and discussions:\n\ud83d\udc49 [Discord Support Server](https://discord.gg/pGYmZxUKB7)\n\n## \ud83d\udcdc License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## From Me!\nWill slowly be adding more sports along our journey! SofaScore API is written to re-use requests for multiple sports, So in theory making requests for a sport other than football (soccer) will allow you to make requests with any class (match, player, etc). Any requests for the dedicated sport that you cannot, they will be under the dedicated sport i.e Basketball.player_stats() rather than Player.stats()\n\n- If you encounter any issues feel free to open an issue.\n- If you have any enhancement requests, feel free to open an issue with the front end proof of what you're looking to get.\n- Always open to pull requests!\n\n## Examples\nCheck out some more use cases from the examples folder!\n\n---\nEnjoy using **Sofascore Wrapper**! \ud83c\udf89\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python API wrapper for https://www.sofascore.com",
"version": "1.0.23",
"project_urls": {
"Homepage": "https://github.com/tommhe14/sofascore-wrapper"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d8677b6a63905db59818d51e843b89dfbed37ae65f1dc5eb790999cbfaa7ab07",
"md5": "3e6a2302d4fb2e0d8eacaeaa68e2bffa",
"sha256": "fb747e1ca7c4864705f7f94998cefb0ff5c09c55af056b00bf9eb522e54747c3"
},
"downloads": -1,
"filename": "sofascore_wrapper-1.0.23-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3e6a2302d4fb2e0d8eacaeaa68e2bffa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 73614,
"upload_time": "2025-02-08T22:35:13",
"upload_time_iso_8601": "2025-02-08T22:35:13.355586Z",
"url": "https://files.pythonhosted.org/packages/d8/67/7b6a63905db59818d51e843b89dfbed37ae65f1dc5eb790999cbfaa7ab07/sofascore_wrapper-1.0.23-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b516d11a09d717ae472e73c24677f9dfb6d7918cc64a41f1d76dd75bb21f4a99",
"md5": "f616d5700ef42f926a1bd595e791c7c9",
"sha256": "5607bac894998195aac156c394c3370ecb874bb97d6a47ac7198e1e3dce41de2"
},
"downloads": -1,
"filename": "sofascore_wrapper-1.0.23.tar.gz",
"has_sig": false,
"md5_digest": "f616d5700ef42f926a1bd595e791c7c9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 58009,
"upload_time": "2025-02-08T22:35:15",
"upload_time_iso_8601": "2025-02-08T22:35:15.236667Z",
"url": "https://files.pythonhosted.org/packages/b5/16/d11a09d717ae472e73c24677f9dfb6d7918cc64a41f1d76dd75bb21f4a99/sofascore_wrapper-1.0.23.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-08 22:35:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tommhe14",
"github_project": "sofascore-wrapper",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "aiohttp",
"specs": [
[
">=",
"3.9.3"
]
]
}
],
"lcname": "sofascore-wrapper"
}
JSON
