# KickoffAPI - Python SDK

```python
pip install requests
from kickoffapi import KickoffAPI

api = KickoffAPI("YOUR_API_KEY")  # free key: https://kickoffapi.com/portal/
print(api.live_scores())
print(api.standings(league="lg_8K3mZ0pQ", season=2025))
```

Talks to **v2** by default (`base_url="https://api.kickoffapi.com/api/v2"`), so every method
returns the unified envelope (`{"data": [...], "meta": {...}}`) with v2's native ids
(`lg_...`, `tm_...`, `fx_...`). Pass `base_url="https://api.kickoffapi.com/api/v1"` to talk to
the legacy API instead, where responses use `{"get": ..., "results": ..., "response": [...]}`
and numeric ids. See the [v2 reference](https://docs.kickoffapi.com/api-v2-reference.html) or the
[v1 reference](https://docs.kickoffapi.com/api-v1-reference.html) (legacy, sunsets 01 Jan 2027).