nike/docs/rapidapi-football-api-reference.md

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.