API Access
Open data for researchers, analysts, and hobbyists.
Free, open data
PlayerElo is a passion project under LivingMeta. The full rating database — 78K+ players and 6K+ coaches across 176competitions — is available via REST API at fair-use rate limits.
Need an API key? Email [email protected] with a brief description of your use case.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /v1/players | Top players by Elo |
| GET | /v1/players/{id} | Single player by ID |
| GET | /v1/players/search?q= | Fuzzy name search |
| GET | /v1/players/team/{team} | Players by team |
| GET | /v1/players/league/{league} | Players by league |
| GET | /v1/coaches | Top coaches by Elo |
| GET | /v1/coaches/{id} | Single coach by ID |
Quick Start
cURL
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://footballelo-api-main-6a89e0a.d2.zuplo.dev/v1/players?limit=10Python
import requests
url = "https://footballelo-api-main-6a89e0a.d2.zuplo.dev/v1/players"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
params = {"limit": 10}
response = requests.get(url, headers=headers, params=params)
players = response.json()
for p in players:
print(f"{p['name']}: {p['elo']}")