AFL API Documentation
v1.2.4 16 endpoints
https://v1.afl.sportsdataapi.com Endpoints
Timezone
1 endpoint GET /timezone timezone
Get the list of available timezone to be used in the
Parameters: This endpoint does not require any parameters.
games and odds endpoint.Parameters: This endpoint does not require any parameters.
GET https://v1.afl.sportsdataapi.com/timezone This endpoint does not require any query parameters.
Seasons
1 endpoint GET /seasons seasons
Return the list of all available seasons.
All seasons are only 4-digit keys, so for a league whose season is
All
Parameters: This endpoint does not require any parameters.
All seasons are only 4-digit keys, so for a league whose season is
2022-2023 the season in the API will be 2022.All
seasons can be used in other endpoints as parameter.Parameters: This endpoint does not require any parameters.
GET https://v1.afl.sportsdataapi.com/seasons This endpoint does not require any query parameters.
Leagues
1 endpoint GET /leagues leagues
Get the list of available leagues.
The league
You can find all the leagues ids on our [Dashboard](https://dashboard.sportsdataapi.com/afl/ids).
Parameters: Most of the parameters of this endpoint can be used together.
The league
id are unique in the API and leagues keep it across all seasonsYou can find all the leagues ids on our [Dashboard](https://dashboard.sportsdataapi.com/afl/ids).
Parameters: Most of the parameters of this endpoint can be used together.
GET https://v1.afl.sportsdataapi.com/leagues Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the league | |
| season | integer | The season of the league | |
| current | string | The state of the league truefalse | |
| timezone | string | A valid timezone |
Teams
2 endpoints GET /teams teams
Return a list of available teams.
The team
You can find all the teams ids on our [Dashboard](https://dashboard.sportsdataapi.com/afl/ids/teams).
Parameters: You can call this endpoint without any parameters to get the complete list.
This endpoint is updated every day
The team
id are unique in the API.You can find all the teams ids on our [Dashboard](https://dashboard.sportsdataapi.com/afl/ids/teams).
Parameters: You can call this endpoint without any parameters to get the complete list.
This endpoint is updated every day
GET https://v1.afl.sportsdataapi.com/teams Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the team | |
| name | string | The name of the team | |
| league | integer | The id of the league | Requires the field season | |
| season | integer | The season of the league | Requires the field League` | |
| search | string | The name of the team |
GET /teams/statistics statistics
Return teams statistics for a given season.
Parameters: This endpoint requires at least theses parameters : id, season.
This endpoint is updated every day
Parameters: This endpoint requires at least theses parameters : id, season.
This endpoint is updated every day
GET https://v1.afl.sportsdataapi.com/teams/statistics Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the team | |
| season | integer | The season of the league |
Players
2 endpoints GET /players players
Return a list of available players.
The player
Parameters: This endpoint requires at least one of theses parameters : id, team, name, search.
This endpoint is updated every day
The player
id are unique in the API and keep it among all the competitions in which they participate.Parameters: This endpoint requires at least one of theses parameters : id, team, name, search.
This endpoint is updated every day
GET https://v1.afl.sportsdataapi.com/players Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the player | |
| name | string | The name of the player | |
| team | integer | The id of the team | Requires the field Season | |
| season | integer | The season of the league | Requires the field Team | |
| search | string | The name of the player |
GET /players/statistics statistics
Return the statistics of a player for a given season.
Parameters: This endpoint requires at least theses parameters : id, season.
This endpoint is updated every day
Parameters: This endpoint requires at least theses parameters : id, season.
This endpoint is updated every day
GET https://v1.afl.sportsdataapi.com/players/statistics Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the player | |
| season | integer | A valid season |
Games
5 endpoints GET /games games
Return the list of games according to the given parameters.
For all requests to games you can add the query parameter
To know the list of available timezones you have to use the endpoint
Available Status
* NS : Not Started * Q1 : 1st Quarter * Q2 : 2nd Quarter * Q3 : 3rd Quarter * Q4 : 4th Quarter * QT : Quarter Time * ER : End Of Regulation * FT : Full Time * HT : Half Time * CANC : Cancelled (Game cancelled and not rescheduled) * PST : Postponed (Game postponed and waiting for a new Game date)
Parameters: This endpoint requires at least one of these parameters : id, date, league, season, team.
This endpoint is updated every 30 seconds
For all requests to games you can add the query parameter
timezone to your request in order to retrieve the list of games in the timezone of your choice like *“Europe/London“*. In case the timezone is not recognized, empty or is not part of the endpoint timezone list, the UTC value will be applied by default.To know the list of available timezones you have to use the endpoint
timezone.Available Status
* NS : Not Started * Q1 : 1st Quarter * Q2 : 2nd Quarter * Q3 : 3rd Quarter * Q4 : 4th Quarter * QT : Quarter Time * ER : End Of Regulation * FT : Full Time * HT : Half Time * CANC : Cancelled (Game cancelled and not rescheduled) * PST : Postponed (Game postponed and waiting for a new Game date)
Parameters: This endpoint requires at least one of these parameters : id, date, league, season, team.
This endpoint is updated every 30 seconds
GET https://v1.afl.sportsdataapi.com/games Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the game | |
| date | string | A valid date | |
| league | integer | The id of the league | Requires the field Season | |
| season | integer | The season of the league | Requires the field League. | |
| team | integer | The id of the team | Requires the field Season | |
| timezone | string | A valid timezone |
GET /games/quarters quarters
Return team scores by quarter for on or several games
Parameters: This endpoint requires at least one of theses parameters : id, ids, date.
This endpoint is updated every 30 seconds
id.Parameters: This endpoint requires at least one of theses parameters : id, ids, date.
This endpoint is updated every 30 seconds
GET https://v1.afl.sportsdataapi.com/games/quarters Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the game | |
| ids | string | One or more games ids id-id-id | |
| date | string | A valid date | |
| timezone | string | A valid timezone |
GET /games/events events
Return the list of events for one or several games
Parameters: This endpoint requires at least one of theses parameters : id, ids, date.
This endpoint is updated every 30 seconds
id.Parameters: This endpoint requires at least one of theses parameters : id, ids, date.
This endpoint is updated every 30 seconds
GET https://v1.afl.sportsdataapi.com/games/events Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the game | |
| ids | string | One or more games ids id-id-id | |
| date | string | A valid date | |
| timezone | string | A valid timezone |
GET /games/statistics/teams teams statistics
Return teams statistics for one or several games
Parameters: This endpoint requires at least one of theses parameters : id, ids, date.
This endpoint is updated every 30 seconds
id.Parameters: This endpoint requires at least one of theses parameters : id, ids, date.
This endpoint is updated every 30 seconds
GET https://v1.afl.sportsdataapi.com/games/statistics/teams Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the game | |
| ids | string | One or more games ids id-id-id | |
| date | string | A valid date | |
| timezone | string | A valid timezone |
GET /games/statistics/players players statistics
Return players statistics for one or several games
Parameters: This endpoint requires at least one of theses parameters : id, ids, date.
This endpoint is updated every 30 seconds
id.Parameters: This endpoint requires at least one of theses parameters : id, ids, date.
This endpoint is updated every 30 seconds
GET https://v1.afl.sportsdataapi.com/games/statistics/players Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the game | |
| ids | string | One or more games ids id-id-id | |
| date | string | A valid date | |
| timezone | string | A valid timezone |
Standings
1 endpoint GET /standings standings
Return the standings of a competition in relation to a given season.
Parameters: This endpoint requires at least two parameters
This endpoint is updated every hour
Parameters: This endpoint requires at least two parameters
league and season.This endpoint is updated every hour
GET https://v1.afl.sportsdataapi.com/standings Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| league | integer | The id of the league | |
| season | integer | The season of the league | |
| team | integer | The id of the team | Requires the field season |
Odds
3 endpoints GET /odds odds
Return the list of available odds for games.
We provide pre-match odds between 1 and 7 days before the game.
We keep a 7-day history *(The availability of odds may vary according to the games, seasons and bookmakers)*
Parameters: This endpoint requires at least one of theses parameters : game.
Odds are updated four times a day
We provide pre-match odds between 1 and 7 days before the game.
We keep a 7-day history *(The availability of odds may vary according to the games, seasons and bookmakers)*
Parameters: This endpoint requires at least one of theses parameters : game.
Odds are updated four times a day
GET https://v1.afl.sportsdataapi.com/odds Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| game | integer | The id of the game | |
| bookmaker | integer | The id of the bookmaker | |
| bet | integer | The id of the bet |
GET /odds/bets bets
Return the list of available bets for odds.
All bets
Parameters: You can call this endpoint without any parameters to get the complete list.
All bets
id can be used in endpoint odds as filtersParameters: You can call this endpoint without any parameters to get the complete list.
GET https://v1.afl.sportsdataapi.com/odds/bets Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the bet | |
| search | string | The name of the bet |
GET /odds/bookmakers bookmakers
Return the list of available bookmakers for odds.
All bookmakers
Parameters: You can call this endpoint without any parameters to get the complete list.
All bookmakers
id can be used in endpoint odds as filters.Parameters: You can call this endpoint without any parameters to get the complete list.
GET https://v1.afl.sportsdataapi.com/odds/bookmakers Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the bookmaker | |
| search | string | The name of the bookmaker |
Quick Reference
Base URL
https://v1.afl.sportsdataapi.com Authentication
x-apisports-key: YOUR_API_KEY cURL
curl -X GET "https://v1.afl.sportsdataapi.com/timezone" \
-H "x-apisports-key: YOUR_API_KEY"Start free. Scale when ready.
Get 100 free afl API requests per day. No credit card required.
Upgrade to PRO for full real-time data, live odds, and unlimited historical access.