Robert Helewka
ee8436d5b8
Add complete Nike football data platform with: - FastMCP server exposing football data tools over HTTP - RapidAPI client for free-api-live-football-data integration - Bootstrap web dashboard with live match/standings views - REST API endpoints for dashboard consumption - Docker support with multi-stage build - Comprehensive README with architecture docs - Minimal .gitignore replacing verbose Python template
261 lines
5.9 KiB
Markdown
261 lines
5.9 KiB
Markdown
# Free API Live Football Data — API Reference
|
|
|
|
**Provider:** Sby Smart API (Creativesdev) on RapidAPI
|
|
**Base URL:** `https://free-api-live-football-data.p.rapidapi.com`
|
|
|
|
## Authentication
|
|
|
|
All requests require two headers:
|
|
|
|
```
|
|
x-rapidapi-host: free-api-live-football-data.p.rapidapi.com
|
|
x-rapidapi-key: YOUR_API_KEY
|
|
```
|
|
|
|
## Pricing
|
|
|
|
| Plan | Price | Requests/Month |
|
|
|------|-------|----------------|
|
|
| Basic (Free) | $0 | 100 |
|
|
| Pro | $9.99/mo | 20,000 |
|
|
| Ultra | $19.99/mo | 200,000 |
|
|
| Mega | $49.99/mo | 500,000 |
|
|
|
|
All plans include the same features/endpoints — only volume differs.
|
|
|
|
---
|
|
|
|
## Key IDs
|
|
|
|
- **leagueid** — League identifier (e.g., `42` for Premier League, `47` for another league). Use search or league list to find MLS ID.
|
|
- **teamid** — Team identifier (e.g., `8650`). Use team search or team list to find.
|
|
- **playerid** — Player identifier (e.g., `671529`). Use player search or squad list to find.
|
|
- **eventid** — Match/event identifier (e.g., `4621624`). Use fixtures or livescores to find.
|
|
|
|
---
|
|
|
|
## Endpoints
|
|
|
|
### Popular Leagues
|
|
|
|
```
|
|
GET /football-popular-leagues
|
|
```
|
|
|
|
### Countries
|
|
|
|
```
|
|
GET /football-get-all-countries
|
|
```
|
|
|
|
### Seasons
|
|
|
|
```
|
|
GET /football-league-all-seasons
|
|
```
|
|
|
|
---
|
|
|
|
### Livescores
|
|
|
|
```
|
|
GET /football-current-live
|
|
```
|
|
|
|
Returns all currently live matches worldwide with scores, status, and timing info.
|
|
|
|
---
|
|
|
|
### Fixtures
|
|
|
|
```
|
|
GET /football-get-matches-by-date?date={YYYYMMDD}
|
|
GET /football-get-matches-by-date-and-league?date={YYYYMMDD}
|
|
GET /football-get-all-matches-by-league?leagueid={leagueid}
|
|
```
|
|
|
|
---
|
|
|
|
### Leagues
|
|
|
|
```
|
|
GET /football-get-all-leagues
|
|
GET /football-get-all-leagues-with-countries
|
|
GET /football-get-league-detail?leagueid={leagueid}
|
|
GET /football-get-league-logo?leagueid={leagueid}
|
|
```
|
|
|
|
---
|
|
|
|
### Teams
|
|
|
|
```
|
|
GET /football-get-list-all-team?leagueid={leagueid}
|
|
GET /football-get-list-home-team?leagueid={leagueid}
|
|
GET /football-get-list-away-team?leagueid={leagueid}
|
|
GET /football-league-team?teamid={teamid}
|
|
GET /football-team-logo?teamid={teamid}
|
|
```
|
|
|
|
---
|
|
|
|
### Players / Athletes / Squad
|
|
|
|
```
|
|
GET /football-get-list-player?teamid={teamid}
|
|
GET /football-get-player-detail?playerid={playerid}
|
|
GET /football-get-player-logo?playerid={playerid}
|
|
```
|
|
|
|
---
|
|
|
|
### Events / Matches
|
|
|
|
```
|
|
GET /football-get-match-detail?eventid={eventid}
|
|
GET /football-get-match-score?eventid={eventid}
|
|
GET /football-get-match-status?eventid={eventid}
|
|
GET /football-get-match-highlights?eventid={eventid}
|
|
GET /football-get-match-location?eventid={eventid}
|
|
GET /football-get-match-all-stats?eventid={eventid}
|
|
GET /football-get-match-firstHalf-stats?eventid={eventid}
|
|
GET /football-get-match-secondhalf-stats?eventid={eventid}
|
|
GET /football-get-match-referee?eventid={eventid}
|
|
```
|
|
|
|
---
|
|
|
|
### Odds
|
|
|
|
```
|
|
GET /football-event-odds?eventid={eventid}&countrycode={CC}
|
|
GET /football-get-match-oddspoll?eventid={eventid}
|
|
GET /football-get-match-odds-voteresult?eventid={eventid}
|
|
```
|
|
|
|
---
|
|
|
|
### Statistics
|
|
|
|
```
|
|
GET /football-get-match-event-all-stats?eventid={eventid}
|
|
GET /football-get-match-event-firstHalf-stats?eventid={eventid}
|
|
GET /football-get-match-event-secondhalf-stats?eventid={eventid}
|
|
```
|
|
|
|
---
|
|
|
|
### Lineups
|
|
|
|
```
|
|
GET /football-get-hometeam-lineup?eventid={eventid}
|
|
GET /football-get-awayteam-lineup?eventid={eventid}
|
|
```
|
|
|
|
---
|
|
|
|
### Head to Head
|
|
|
|
```
|
|
GET /football-get-head-to-head?eventid={eventid}
|
|
```
|
|
|
|
---
|
|
|
|
### Standings
|
|
|
|
```
|
|
GET /football-get-standing-all?leagueid={leagueid}
|
|
GET /football-get-standing-home?leagueid={leagueid}
|
|
GET /football-get-standing-away?leagueid={leagueid}
|
|
```
|
|
|
|
---
|
|
|
|
### Rounds
|
|
|
|
```
|
|
GET /football-get-all-rounds?leagueid={leagueid}
|
|
GET /football-get-rounds-detail?roundid={roundid}
|
|
GET /football-get-rounds-players?leagueid={leagueid}
|
|
```
|
|
|
|
---
|
|
|
|
### Trophies
|
|
|
|
```
|
|
GET /football-get-trophies-all-seasons?leagueid={leagueid}
|
|
GET /football-get-trophies-detail?leagueid={leagueid}&season={season}
|
|
```
|
|
|
|
Season format example: `2023/2024` (URL-encoded as `2023%2F2024`)
|
|
|
|
---
|
|
|
|
### Top Players
|
|
|
|
```
|
|
GET /football-get-top-players-by-assists?leagueid={leagueid}
|
|
GET /football-get-top-players-by-goals?leagueid={leagueid}
|
|
GET /football-get-top-players-by-rating?leagueid={leagueid}
|
|
```
|
|
|
|
---
|
|
|
|
### Transfers
|
|
|
|
```
|
|
GET /football-get-all-transfers?page={page}
|
|
GET /football-get-top-transfers?page={page}
|
|
GET /football-get-market-value-transfers?page={page}
|
|
GET /football-get-league-transfers?leagueid={leagueid}
|
|
GET /football-get-team-contract-extension-transfers?teamid={teamid}
|
|
GET /football-get-team-players-in-transfers?teamid={teamid}
|
|
GET /football-get-team-players-out-transfers?teamid={teamid}
|
|
```
|
|
|
|
---
|
|
|
|
### News
|
|
|
|
```
|
|
GET /football-get-trendingnews
|
|
GET /football-get-league-news?leagueid={leagueid}&page={page}
|
|
GET /football-get-team-news?teamid={teamid}&page={page}
|
|
```
|
|
|
|
---
|
|
|
|
### Search
|
|
|
|
```
|
|
GET /football-all-search?search={query}
|
|
GET /football-teams-search?search={query}
|
|
GET /football-players-search?search={query}
|
|
GET /football-leagues-search?search={query}
|
|
GET /football-matches-search?search={query}
|
|
```
|
|
|
|
---
|
|
|
|
## Typical Workflow for MLS
|
|
|
|
1. **Find MLS league ID:** `GET /football-leagues-search?search=mls`
|
|
2. **Get Toronto FC team ID:** `GET /football-teams-search?search=toronto`
|
|
3. **Get upcoming fixtures:** `GET /football-get-all-matches-by-league?leagueid={MLS_ID}`
|
|
4. **Get live scores:** `GET /football-current-live` (filter for MLS matches)
|
|
5. **Get match details:** `GET /football-get-match-detail?eventid={eventid}`
|
|
6. **Get lineups:** `GET /football-get-hometeam-lineup?eventid={eventid}`
|
|
7. **Get match stats:** `GET /football-get-match-all-stats?eventid={eventid}`
|
|
8. **Get standings:** `GET /football-get-standing-all?leagueid={MLS_ID}`
|
|
|
|
---
|
|
|
|
## Notes
|
|
|
|
- Data appears to be sourced from FotMob based on field naming conventions and ID patterns.
|
|
- No external documentation exists — this reference was compiled from the RapidAPI playground.
|
|
- Date format for fixtures: `YYYYMMDD` (e.g., `20241107`)
|
|
- The "Statistics" category endpoints overlap with the match stats endpoints under "Events/Matches" — they may return the same or differently structured data. Test both.
|