# 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.