{ "openapi": "3.0.1", "info": { "title": "AFL Tables Scraper", "description": "Scrapes AFL and VFL match results, player statistics, season ladders and Brownlow Medal votes from AFL Tables for every season from 1897 to today, including scores, quarter-by-quarter progression, venues, attendance, per-player disposals, goals, kicks, marks and tackles, and full standings.", "version": "1.0", "x-build-id": "DLdxaiHDzzC02ZCld" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kinaesthetic_millionaire~afl-tables-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kinaesthetic_millionaire-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/kinaesthetic_millionaire~afl-tables-scraper/runs": { "post": { "operationId": "runs-sync-kinaesthetic_millionaire-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/kinaesthetic_millionaire~afl-tables-scraper/run-sync": { "post": { "operationId": "run-sync-kinaesthetic_millionaire-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", "properties": { "startUrls": { "title": "AFL Tables pages (optional)", "type": "array", "description": "Optional AFL Tables pages to scrape instead of choosing a season below: a season page such as https://afltables.com/afl/seas/2024.html (match results or ladder, depending on the mode), a player statistics page such as https://afltables.com/afl/stats/2024.html, or a Brownlow Medal page such as https://afltables.com/afl/brownlow/brownlow2024.html. Leave empty to use the mode and season below.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "mode": { "title": "What to scrape", "enum": [ "matches", "playerStats", "ladder", "brownlowMedal" ], "type": "string", "description": "Match results with scores and venues, per-player season statistics, the season ladder (standings), or Brownlow Medal votes.", "default": "matches" }, "season": { "title": "Season", "minimum": 1897, "type": "integer", "description": "The season (year) to scrape, from 1897 to the current season. Used when no AFL Tables pages are given above. Brownlow Medal votes exist from 1924 onwards.", "default": 2024 }, "roundNumber": { "title": "Round number", "minimum": 1, "type": "integer", "description": "Only for match results: return just this home-and-away round, for example 1. Leave empty for the whole season. Finals are not returned when a round number is set." }, "includeFinals": { "title": "Include finals", "type": "boolean", "description": "Only for match results: also return finals matches (qualifying, elimination and semi finals, preliminary finals and the grand final).", "default": true }, "includeByes": { "title": "Include byes", "type": "boolean", "description": "Only for match results: also return a row for every team that had a bye in a round.", "default": false }, "team": { "title": "Team", "type": "string", "description": "Only return data for one team, for example Collingwood or Brisbane Lions. Applies to match results (either side), player statistics, the ladder and Brownlow Medal votes. Leave empty for all teams." }, "maxItems": { "title": "Max items per start URL", "minimum": 1, "type": "integer", "description": "Maximum number of items (matches, players, ladder rows or Brownlow rows) to return for each season page.", "default": 5 }, "projectName": { "title": "Project name (enables caching)", "type": "string", "description": "Set a project name to enable cross-run caching, for example \"afl-2025\". The Actor remembers the items it returned under that project and skips them in later runs of the same project, so a weekly run returns only new matches. Each project keeps its own separate history, so using a different name starts fresh. Leave empty to scrape everything every time." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings used for all requests. The Actor works without a proxy.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }