# AFL Tables Scraper (`crawlerbros/afl-tables-scraper`) Actor Scrape AFL/VFL match results, player statistics, and season ladders from afltables.com - every season from 1897 to today. Scores, dates, venues, attendance, per-player disposals/goals/kicks/marks/tackles, and full standings. - **URL**: https://apify.com/crawlerbros/afl-tables-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## AFL Tables Scraper Scrape AFL/VFL match results, player statistics, and season ladders from [afltables.com](https://afltables.com) — the definitive historical archive of Australian Rules Football, covering every season from **1897 to today**. Plain HTTP, no login, no cookies, no proxy required. ### What this actor does - **Four modes:** `matches`, `playerStats`, `ladder`, `brownlowMedal` - **Match results** — every game of a season: scores by quarter, final score, date, venue, attendance, margin, and a link to the detailed match-stats page - **Player statistics** — full season per-player box scores: games, kicks, marks, handballs, disposals, goals, behinds, hitouts, tackles, clearances, clangers, Brownlow votes, contested/uncontested possessions, and more (advanced stats are only tracked from the era the AFL started recording them; older seasons return whichever fields the source actually published) - **Ladder / standings** — final season table: position, played/won/drawn/lost, home & away records, points for/against with goal-behind breakdowns, percentage, and premiership points (plus finals ranking for finals-era seasons) — this single table doubles as each team's season summary - **Brownlow Medal winners** — the full year-by-year winners list (1924-present): player, team, total votes, games played, 3/2/1-vote game counts, games polled, and vote average — including joint/tied winner years - **129 seasons of data** — 1897 (the first VFL season) through the current AFL season - **Team filter** — restrict any mode to one of 21 current + historical AFL/VFL clubs - **Empty fields are omitted** — a record only ever contains fields the source actually published ### Output per mode #### `matches` - `season`, `round`, `roundNumber` (omitted for finals), `isFinals` - `homeTeam`, `homeTeamUrl`, `homeTeamSlug`, `homeScore`, `homeScoreProgression` (quarter-by-quarter) - `awayTeam`, `awayTeamUrl`, `awayTeamSlug`, `awayScore`, `awayScoreProgression` - `matchDate`, `matchDateIso`, `venue`, `venueUrl`, `attendance` - `isDraw`, `winningTeam`, `margin` - `matchStatsUrl`, `sourceUrl` - Bye rounds are emitted as separate records: `season`, `round`, `roundNumber`, `isBye: true`, `team`, `teamUrl`, `teamSlug` #### `playerStats` - `season`, `team`, `teamUrl`, `teamSlug`, `jumperNumber`, `playerName`, `playerNameRaw` (source `Last, First` form), `playerUrl` - `games`, `kicks`, `marks`, `handballs`, `disposals`, `disposalAverage`, `goals`, `behinds`, `hitouts`, `tackles`, `rebound50s`, `inside50s`, `clearances`, `clangers`, `freesFor`, `freesAgainst`, `brownlowVotes`, `contestedPossessions`, `uncontestedPossessions`, `contestedMarks`, `marksInside50`, `onePercenters`, `bounces`, `goalAssists`, `percentGamePlayed`, `substitute` #### `ladder` - `season`, `position`, `team`, `teamUrl`, `teamSlug`, `played`, `wins`, `draws`, `losses`, `homeRecord`, `awayRecord` - `pointsFor`, `pointsForGoals`, `pointsForBehinds`, `pointsForAccuracyPercent` - `pointsAgainst`, `pointsAgainstGoals`, `pointsAgainstBehinds`, `pointsAgainstAccuracyPercent` - `percentage`, `premiershipPoints`, `finalPosition`, `finalRating` (finals-era seasons only) #### `brownlowMedal` - `season` (the year the medal was awarded), `playerName`, `playerUrl`, `team`, `teamUrl`, `teamSlug` - `votes` (total), `gamesPlayed`, `threeVoteGames`, `twoVoteGames`, `oneVoteGames`, `gamesPolled`, `voteAverage` - Not season-scoped — always returns the full 1924-present list (respecting `maxItems` and the `team` filter); the `season` input field is ignored for this mode - Joint/tied winner years emit one record per winner (e.g. 2012's Sam Mitchell and Trent Cotchin) Every record also carries `recordType`, `scrapedAt`, and `sourceUrl`. ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `matches` | `matches` / `playerStats` / `ladder` / `brownlowMedal` | | `season` | integer | `2025` | AFL/VFL season year, 1897–2026 (ignored by `brownlowMedal`) | | `roundNumber` | integer | – | Filter matches/byes to one home-and-away round (1–30) | | `includeFinals` | bool | `true` | Include finals-series matches (mode=matches) | | `includeByes` | bool | `true` | Include bye-round records (mode=matches) | | `team` | string | – | Restrict to one club (all modes) | | `maxItems` | int | `100` | Hard cap on emitted records (1–2000) | | `proxyConfiguration` | object | AUTO | Not required by the source; kept as a resilience fallback | #### Example: 2025 Grand Final round results ```json { "mode": "matches", "season": 2025, "includeFinals": true, "maxItems": 50 } ```` #### Example: Geelong's 2025 player stats ```json { "mode": "playerStats", "season": 2025, "team": "geelong", "maxItems": 100 } ``` #### Example: final 1897 ladder (the first VFL season) ```json { "mode": "ladder", "season": 1897 } ``` #### Example: every Brownlow Medal winner (1924-present) ```json { "mode": "brownlowMedal", "maxItems": 200 } ``` ### Use cases - **Sports analytics** — build historical models of team form, scoring trends, and margins - **Fantasy football tools** — feed per-player season stats into fantasy scoring engines - **Betting research** — study historical venue/attendance/margin patterns - **Journalism & content** — pull accurate historical scorelines and ladders for articles - **Academic research** — long-run (1897–present) sports-history datasets ### FAQ **What's AFL Tables?** A free, long-running statistical archive of the Australian Football League (and its VFL predecessor), maintained since the 1990s. It's the most complete public record of AFL/VFL results and player statistics. **How far back does the data go?** Every season from 1897 (the first VFL season) to the current season. **Why are some player-stat fields missing for older seasons?** The AFL/VFL didn't track advanced stats (contested possessions, clangers, etc.) until relatively recently. The actor only emits fields the source page actually published for that season — it never fabricates data. **What are `homeTeam` / `awayTeam`?** afltables.com always lists the two teams of a fixture in a fixed order; the first-listed team is the host per the official AFL draw. **What does `roundNumber` being absent mean?** The match was part of the finals series (Qualifying/Elimination/Semi/Preliminary/Grand Final), which isn't numbered like home-and-away rounds — see `round` and `isFinals` instead. **Does the ladder include finals ranking?** Yes, when available — `finalPosition` and `finalRating` are populated only for seasons that used a finals-era ranking system on the source page. **Does the Brownlow Medal mode need a season?** No — `mode=brownlowMedal` always returns the complete year-by-year winners list; the `season` input is ignored for this mode. Use `maxItems` or the `team` filter to narrow it down. **Is a proxy required?** No. afltables.com is a plain, unprotected HTML site. The `proxyConfiguration` input defaults to Apify's free `AUTO` datacenter group purely as a resilience fallback and adds no cost. **How fresh is the data?** afltables.com updates within a day or two of each round being completed. ### Limitations Each team's index page (`afltables.com/afl/teams/_idx.html`) links out to over a dozen additional, differently-structured pages per club — individual career player records, coaching lists, win/loss records, attendance history, venue records, streaks, and season-by-season game lists. These are genuinely useful axes but each requires its own dedicated parser for a page format not shared with `matches`/`playerStats`/`ladder`/`brownlowMedal`, so they're out of scope for this actor. The existing `team` filter already covers the common case of narrowing any of the four modes to one club's season-scoped data. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `season` (type: `integer`): AFL/VFL season year. Data is available from 1897 (first VFL season) through the current season. Not used by mode=brownlowMedal (that mode returns the full year-by-year winners list). ## `roundNumber` (type: `integer`): Only include home-and-away rounds matching this round number. Leave blank for all rounds. Does not restrict finals (see `Include finals series`). ## `includeFinals` (type: `boolean`): Include finals matches (Qualifying/Elimination/Semi/Preliminary/Grand Final). ## `includeByes` (type: `boolean`): Include a record for each team that had a bye in a given round. ## `team` (type: `string`): Restrict results to one club. Applies to all modes: matches (home or away), player stats, ladder, and Brownlow Medal winners. Leave blank for all teams. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## `proxyConfiguration` (type: `object`): afltables.com serves plain server-rendered HTML with no anti-bot protection and works without any proxy from datacenter IPs. Leave AUTO on for resilience; no paid proxy group is required or used. ## Actor input object example ```json { "mode": "matches", "season": 2025, "includeFinals": true, "includeByes": true, "team": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `records` (type: `string`): Dataset containing all scraped matches, byes, player-stat rows, or ladder rows. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "matches", "season": 2025, "includeFinals": true, "includeByes": true, "team": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/afl-tables-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "matches", "season": 2025, "includeFinals": True, "includeByes": True, "team": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/afl-tables-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "matches", "season": 2025, "includeFinals": true, "includeByes": true, "team": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/afl-tables-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/afl-tables-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AFL Tables Scraper", "description": "Scrape AFL/VFL match results, player statistics, and season ladders from afltables.com - every season from 1897 to today. Scores, dates, venues, attendance, per-player disposals/goals/kicks/marks/tackles, and full standings.", "version": "1.0", "x-build-id": "kg5vINjIJNE9Su7FX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~afl-tables-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-afl-tables-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~afl-tables-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-afl-tables-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~afl-tables-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-afl-tables-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode", "season" ], "properties": { "mode": { "title": "Mode", "enum": [ "matches", "playerStats", "ladder", "brownlowMedal" ], "type": "string", "description": "What to fetch.", "default": "matches" }, "season": { "title": "Season", "minimum": 1897, "maximum": 2026, "type": "integer", "description": "AFL/VFL season year. Data is available from 1897 (first VFL season) through the current season. Not used by mode=brownlowMedal (that mode returns the full year-by-year winners list).", "default": 2025 }, "roundNumber": { "title": "Round number (mode=matches)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Only include home-and-away rounds matching this round number. Leave blank for all rounds. Does not restrict finals (see `Include finals series`)." }, "includeFinals": { "title": "Include finals series (mode=matches)", "type": "boolean", "description": "Include finals matches (Qualifying/Elimination/Semi/Preliminary/Grand Final).", "default": true }, "includeByes": { "title": "Include bye rounds (mode=matches)", "type": "boolean", "description": "Include a record for each team that had a bye in a given round.", "default": true }, "team": { "title": "Team filter", "enum": [ "", "adelaide", "brisbaneb", "brisbanel", "carlton", "collingwood", "essendon", "fitzroy", "fremantle", "geelong", "goldcoast", "gws", "hawthorn", "melbourne", "kangaroos", "padelaide", "richmond", "stkilda", "swans", "university", "westcoast", "bullldogs" ], "type": "string", "description": "Restrict results to one club. Applies to all modes: matches (home or away), player stats, ladder, and Brownlow Medal winners. Leave blank for all teams.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted records.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "afltables.com serves plain server-rendered HTML with no anti-bot protection and works without any proxy from datacenter IPs. Leave AUTO on for resilience; no paid proxy group is required or used.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```