API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
Access dataset files directly from scripts, code, or AI agents.
Dataset Files
Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.
/fivethirtyeight/soccer-spi/
https://datahub.io/fivethirtyeight/soccer-spi/_r/-/README.md
https://datahub.io/fivethirtyeight/soccer-spi/_r/-/data/spi_global_rankings.csv
https://datahub.io/fivethirtyeight/soccer-spi/_r/-/data/spi_matches.csv
https://datahub.io/fivethirtyeight/soccer-spi/_r/-/datapackage.json
Key Files
Start with these files — they give you everything you need to understand and access the dataset.
datapackage.json— metadata & schema
https://datahub.io/fivethirtyeight/soccer-spi/_r/-/datapackage.json
README.md— documentation
https://datahub.io/fivethirtyeight/soccer-spi/_r/-/README.md
Typical Usage
- 1. Fetch datapackage.json to inspect schema and resources
- 2. Download data resources listed in datapackage.json
- 3. Read README.md for full context
Data Files
Explore with AIspi_global_rankings
| Field | Type | Format |
|---|---|---|
| name | string | default |
| league | string | default |
| rank | integer | default |
| prev_rank | integer | default |
| off | number | default |
| def | number | default |
| spi | number | default |
Download
Download CSVAbout
- Last updated
- 12 March 2026
- Total rows
- ...
- Format
- CSV
- File size
- 25.1 kB
spi_matches
| Field | Type | Format |
|---|---|---|
| date | date | default |
| league_id | integer | default |
| team1 | string | default |
| team2 | string | default |
| spi1 | number | default |
| spi2 | number | default |
| prob1 | number | default |
| prob2 | number | default |
| probtie | number | default |
| proj_score1 | number | default |
| proj_score2 | number | default |
| score1 | integer | default |
| score2 | integer | default |
| xg1 | number | default |
| xg2 | number | default |
| nsxg1 | number | default |
| nsxg2 | number | default |
| adj_score1 | number | default |
| adj_score2 | number | default |
Download
Download CSVAbout
- Last updated
- 12 March 2026
- Total rows
- ...
- Format
- CSV
- File size
- 1.23 MB
About this dataset
SPI Ratings
This file contains links to the data behind our Club Soccer Predictions and Global Club Soccer Rankings.
spi_matches.csv contains match-by-match SPI ratings and forecasts back to 2016.
spi_global_rankings.csv contains current SPI ratings and rankings for men's club teams.
This dataset was scraped from FiveThirtyEight - soccer-spi