AFL Stats API

Returns players ordered alphabetically. Filter by team, search by name, or filter by season year (players who appeared in at least one match that year).

# Search for a player by name
GET /players?name=warner

# All Collingwood players who played in 2024
GET /players?team_id=collingwood&year=2024

{
  "data": [
    { "id": 144, "name": "Chad Warner", "currentTeamId": "sydney-swans", "onlineId": "12345" }
  ],
  "meta": { "limit": 50, "offset": 0, "count": 1, "total": 1 }
}

Returns matches with scores, teams, venue, and crowd. Ordered newest first (year desc, round desc).

# All Sydney Swans matches in 2024
GET /matches?team_id=sydney-swans&year=2024

# Matches at the MCG in a date range
GET /matches?venue=MCG&date_from=2024-06-01&date_to=2024-06-30

# Round 10, 2024
GET /matches?year=2024&round=10

{
  "data": [
    {
      "id": 9812, "round": 5, "year": 2024,
      "homeTeam": "Sydney Swans", "homeShortName": "SYD",
      "awayTeam": "Greater Western Sydney", "awayShortName": "GWS",
      "homeScore": 104, "awayScore": 87,
      "venue": "SCG", "date": "2024-04-20T13:45:00",
      "crowd": 38214, "sourcedAt": "2024-04-21T00:12:44.231Z"
    }
  ],
  "meta": { "limit": 50, "offset": 0, "count": 9, "total": 9 }
}

Query Parameters

Valid sort_by values

kicks, handballs, disposals, marks, goals, behinds, tackles, hitouts,
goal_assists, inside_50s, clearances, clangers, rebound_50s,
frees_for, frees_against, afl_fantasy_pts, supercoach_pts

Examples

# All stats for a single match
GET /player-stats?match_id=9812

# One player's 2024 season, sorted by fantasy points
GET /player-stats?player_id=144&year=2024&sort_by=afl_fantasy_pts

# Top tacklers in round 10
GET /player-stats?year=2024&round=10&sort_by=tackles&limit=10

Response

{
  "data": [
    {
      "matchId": 9812, "playerName": "Chad Warner", "teamId": "sydney-swans",
      "kicks": 18, "handballs": 14, "disposals": 32,
      "marks": 6, "goals": 1, "behinds": 0,
      "tackles": 5, "hitouts": 0, "goalAssists": 2,
      "inside50s": 7, "clearances": 8, "clangers": 3,
      "rebound50s": 1, "freesFor": 2, "freesAgainst": 1,
      "aflFantasyPts": 118, "supercoachPts": 124
    }
  ],
  "meta": { "limit": 50, "offset": 0, "count": 44, "total": 44 }
}

Stat Fields Reference

Query Parameters

Same filter parameters as /player-stats: match_id, player_id, year, round, team_id, sort_by, order, limit, offset.

Valid sort_by values

contested_possessions, uncontested_possessions, effective_disposals,
disposal_efficiency_pct, contested_marks, goal_assists, marks_inside_50,
one_percenters, bounces, centre_clearances, stoppage_clearances,
score_involvements, metres_gained, turnovers, intercepts,
tackles_inside_50, time_on_ground_pct

Example

# Highest metres gained in round 10, 2024
GET /player-stats-advanced?year=2024&round=10&sort_by=metres_gained&limit=10

Advanced Stat Fields Reference

Query Parameters

Examples

# Full club history for a player
GET /player-team-assignments?player_id=144

# All trades into Collingwood
GET /player-team-assignments?team_id=collingwood&reason=trade

Response

{
  "data": [
    {
      "id": 301, "playerName": "Chad Warner", "playerId": 144,
      "teamId": "sydney-swans", "teamName": "Sydney Swans",
      "startYear": 2021, "endYear": null, "reason": "rookie"
    }
  ],
  "meta": { "limit": 50, "offset": 0, "count": 1, "total": 1 }
}

Query Parameters

Valid stat values

kicks, handballs, disposals, marks, goals, behinds, tackles, hitouts,
goal_assists, inside_50s, clearances, clangers, rebound_50s,
frees_for, frees_against, afl_fantasy_pts, supercoach_pts

Examples

# Top 10 disposal getters in 2024
GET /leaderboards?stat=disposals&year=2024&limit=10

# Highest goal tallies in round 5 for Sydney
GET /leaderboards?stat=goals&year=2024&round=5&team_id=sydney-swans

Response

{
  "data": [
    { "playerId": 144, "playerName": "Chad Warner", "teamId": "sydney-swans", "value": 32 },
    { "playerId": 201, "playerName": "Marcus Bontempelli", "teamId": "western-bulldogs", "value": 31 }
  ],
  "meta": { "limit": 10, "offset": 0, "count": 10, "total": 4820 }
}

Query Parameters

Example

# Swans vs Magpies all-time at the SCG
GET /head-to-head?team_a=sydney-swans&team_b=collingwood&venue=SCG

Example

curl /api/afl/v1/venues -H "Authorization: Bearer YOUR_KEY"

Response

{
  "data": [
    { "venue": "MCG", "matchCount": 412 },
    { "venue": "Marvel Stadium", "matchCount": 298 },
    { "venue": "SCG", "matchCount": 186 }
  ],
  "meta": { "count": 24 }
}

Query Parameters

Example

curl "/api/afl/v1/standings?year=2024" -H "Authorization: Bearer YOUR_KEY"

Response

{
  "data": [
    {
      "teamId": "sydney-swans", "teamName": "Sydney Swans", "teamShortName": "SYD",
      "played": 24, "wins": 17, "losses": 6, "draws": 1,
      "pointsFor": 2156, "pointsAgainst": 1742,
      "percentage": 123.77, "premiershipsPoints": 70
    }
  ],
  "meta": { "year": 2024, "count": 18 }
}

Query Parameters

Example

curl "/api/afl/v1/tips?year=2026&round=4" -H "Authorization: Bearer YOUR_KEY"

Response

{
  "data": [
    {
      "id": 1, "gameId": 38201, "year": 2026, "round": 4,
      "hteam": "Sydney Swans", "ateam": "Collingwood",
      "hconfidence": 62, "source": "Squiggle",
      "syncedAt": "2026-04-06T12:00:00.000Z"
    }
  ],
  "meta": { "year": 2026, "round": 4, "count": 9 }
}

Query Parameters

Example

# No auth required
curl /api/afl/v1/fixture?year=2026

Response

{
  "year": 2026,
  "games": [ ... ]  // Squiggle fixture data
}