<!-- omit in toc -->
# itscalledsoccer
<div align="center">
<img src="https://raw.githubusercontent.com/American-Soccer-Analysis/itscalledsoccer-r/main/man/figures/logo.png" align="center" height="175"/>
</div>
<br>
<!-- badges: start -->
[](https://github.com/RichardLitt/standard-readme)
[](https://opensource.org/licenses/MIT)
[](https://pypi.python.org/pypi/itscalledsoccer/)
[](https://codecov.io/github/American-Soccer-Analysis/itscalledsoccer)
<!-- badges: end -->
<!-- omit in toc -->
## Table of Contents
- [Background](#background)
- [Install](#install)
- [Usage](#usage)
- [Other versions](#other-versions)
- [Contributing](#contributing)
- [License](#license)
## Background
`itscalledsoccer` is a wrapper around the same API that powers the [American Soccer Analysis app](https://app.americansocceranalysis.com/). It enables Python users to programmatically retrieve advanced analytics for their favorite [MLS](https://en.wikipedia.org/wiki/Major_League_Soccer), [NWSL](https://en.wikipedia.org/wiki/National_Women%27s_Soccer_League), and [USL](https://en.wikipedia.org/wiki/United_Soccer_League) players and teams.
## Install
```sh
pip install itscalledsoccer
```
## Usage
```python
from itscalledsoccer.client import AmericanSoccerAnalysis
asa_client = AmericanSoccerAnalysis()
```
Any of the `get_*` methods can be used to retrieve the same data made available in the [American Soccer Analysis app](https://app.americansocceranalysis.com/). Partial matches or abbreviations are accepted for any player or team names. For most methods, arguments _must be named_. A few examples are below.
```python
# Get all players named "Andre"
asa_players = asa_client.get_players(names="Andre")
```
For more information, check out the [documentation site](https://american-soccer-analysis.github.io/itscalledsoccer/).
## Other versions
- [itscalledsoccer-r](https://github.com/American-Soccer-Analysis/itscalledsoccer-r)
- [itscalledsoccer-js](https://github.com/American-Soccer-Analysis/itscalledsoccer-js)
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md)
## License
MIT © itscalledsoccer authors
Raw data
{
"_id": null,
"home_page": null,
"name": "itscalledsoccer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "stats, soccer, api, football, american, machine learning",
"author": null,
"author_email": "American Soccer Analysis <americansocceranalysis@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/b0/53/6976200925a40821b67740cfa714d06ceb98b291ecdaf67c21cee940333a/itscalledsoccer-1.3.1.tar.gz",
"platform": null,
"description": "<!-- omit in toc -->\n# itscalledsoccer\n\n<div align=\"center\">\n <img src=\"https://raw.githubusercontent.com/American-Soccer-Analysis/itscalledsoccer-r/main/man/figures/logo.png\" align=\"center\" height=\"175\"/>\n</div>\n\n<br>\n\n\n<!-- badges: start -->\n[](https://github.com/RichardLitt/standard-readme)\n\n\n\n[](https://opensource.org/licenses/MIT)\n[](https://pypi.python.org/pypi/itscalledsoccer/)\n[](https://codecov.io/github/American-Soccer-Analysis/itscalledsoccer)\n<!-- badges: end -->\n\n<!-- omit in toc -->\n## Table of Contents\n\n- [Background](#background)\n- [Install](#install)\n- [Usage](#usage)\n- [Other versions](#other-versions)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Background\n\n`itscalledsoccer` is a wrapper around the same API that powers the [American Soccer Analysis app](https://app.americansocceranalysis.com/). It enables Python users to programmatically retrieve advanced analytics for their favorite [MLS](https://en.wikipedia.org/wiki/Major_League_Soccer), [NWSL](https://en.wikipedia.org/wiki/National_Women%27s_Soccer_League), and [USL](https://en.wikipedia.org/wiki/United_Soccer_League) players and teams.\n\n## Install\n\n```sh\npip install itscalledsoccer\n```\n\n## Usage\n\n```python\nfrom itscalledsoccer.client import AmericanSoccerAnalysis\n\nasa_client = AmericanSoccerAnalysis()\n```\n\nAny of the `get_*` methods can be used to retrieve the same data made available in the [American Soccer Analysis app](https://app.americansocceranalysis.com/). Partial matches or abbreviations are accepted for any player or team names. For most methods, arguments _must be named_. A few examples are below.\n\n```python\n# Get all players named \"Andre\"\nasa_players = asa_client.get_players(names=\"Andre\")\n```\n\nFor more information, check out the [documentation site](https://american-soccer-analysis.github.io/itscalledsoccer/).\n\n## Other versions\n\n- [itscalledsoccer-r](https://github.com/American-Soccer-Analysis/itscalledsoccer-r)\n- [itscalledsoccer-js](https://github.com/American-Soccer-Analysis/itscalledsoccer-js)\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md)\n\n## License\n\nMIT \u00a9 itscalledsoccer authors\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Programmatically interact with the American Soccer Analysis API",
"version": "1.3.1",
"project_urls": {
"Repository": "https://github.com/American-Soccer-Analysis/itscalledsoccer"
},
"split_keywords": [
"stats",
" soccer",
" api",
" football",
" american",
" machine learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f497f9c3fddd0fab53dc69c403fbc7cf8b93af31f13a2e0dab82d167bfc6c6d2",
"md5": "5d3e547944bddaadf8546a9f416286b1",
"sha256": "39437f0c62c8a6c6e57c0bd24e37d451567545a2331b71924e0156e60c779a68"
},
"downloads": -1,
"filename": "itscalledsoccer-1.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5d3e547944bddaadf8546a9f416286b1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 9413,
"upload_time": "2024-12-14T00:08:27",
"upload_time_iso_8601": "2024-12-14T00:08:27.998099Z",
"url": "https://files.pythonhosted.org/packages/f4/97/f9c3fddd0fab53dc69c403fbc7cf8b93af31f13a2e0dab82d167bfc6c6d2/itscalledsoccer-1.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b0536976200925a40821b67740cfa714d06ceb98b291ecdaf67c21cee940333a",
"md5": "68b4e5376cb6d659ea2ab222428dc5bd",
"sha256": "8a853d4b5f16608a234c7176d961372adb3ed8f4cc2ab955c7e7c0ccc5a5f6e8"
},
"downloads": -1,
"filename": "itscalledsoccer-1.3.1.tar.gz",
"has_sig": false,
"md5_digest": "68b4e5376cb6d659ea2ab222428dc5bd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 11628,
"upload_time": "2024-12-14T00:08:30",
"upload_time_iso_8601": "2024-12-14T00:08:30.480342Z",
"url": "https://files.pythonhosted.org/packages/b0/53/6976200925a40821b67740cfa714d06ceb98b291ecdaf67c21cee940333a/itscalledsoccer-1.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-14 00:08:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "American-Soccer-Analysis",
"github_project": "itscalledsoccer",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "itscalledsoccer"
}
JSON
