Metadata-Version: 2.4
Name: silver-bulletin-api
Version: 1.11.2
Summary: Silver Bulletin data API client — PELE soccer ratings, match forecasts, polls
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests
Provides-Extra: pandas
Requires-Dist: pandas; extra == "pandas"
Provides-Extra: plots
Requires-Dist: pandas; extra == "plots"
Requires-Dist: matplotlib; extra == "plots"

# silver-bulletin-api

Python client for the Silver Bulletin data API — PELE international
soccer ratings, match forecasts, and polling data.

An API key is required (issued by the maintainer).

## Setup

```sh
pip install silver-bulletin-api
export SB_API_KEY=sb_..._your_key   # put this in your shell profile
```

## Use

```python
from sb_api import SB
sb = SB()                       # returns pandas DataFrames if pandas is installed

sb.pele.ratings()               # current PELE ratings table
sb.pele.teams("kor")            # find a team
sb.pele.upcoming("BRA")         # upcoming match forecasts
sb.polls.average("trump approval")   # published polling averages
```

Teams accept FIFA codes or names; dates accept `1993`, `1993-06`, or
`1993-06-02`. Endpoints your key doesn't cover raise a clear error.
