{ "openapi": "3.0.1", "info": { "title": "CueTracker Snooker Stats Scraper", "description": "Scrape CueTracker.net snooker data - player profiles & bios, match results, world rankings by season, tournament draws/results, and head-to-head records between any two players. No login or proxy required.", "version": "1.0", "x-build-id": "y5eVeoYeaEWyCEyK4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~cuetracker-snooker-stats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-cuetracker-snooker-stats-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~cuetracker-snooker-stats-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-cuetracker-snooker-stats-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~cuetracker-snooker-stats-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-cuetracker-snooker-stats-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" ], "properties": { "mode": { "title": "Mode", "enum": [ "rankings", "playerProfile", "players", "tournamentResults", "headToHead", "tournamentsBySeason" ], "type": "string", "description": "What to fetch from CueTracker.", "default": "rankings" }, "season": { "title": "Season", "type": "string", "description": "Snooker season in `YYYY-YYYY` format (e.g. `2025-2026`). Used by mode=rankings, mode=playerProfile, mode=tournamentResults and mode=tournamentsBySeason. Leave blank to auto-detect the most recent season with published data." }, "rankingType": { "title": "Ranking type", "enum": [ "start", "finish" ], "type": "string", "description": "CueTracker publishes each season's ranking list as a Start-of-season snapshot (the official world ranking players entered the season with) and a Finish-of-season snapshot (only populated once the season has concluded). Used by mode=rankings.", "default": "start" }, "playerSlugs": { "title": "Player slugs or URLs (mode=playerProfile)", "type": "array", "description": "CueTracker player slugs (e.g. `judd-trump`) or full profile URLs.", "default": [ "judd-trump" ], "items": { "type": "string" } }, "status": { "title": "Match status", "enum": [ "professional", "non-professional" ], "type": "string", "description": "Filter a player's matches to professional or non-professional events. Used by mode=playerProfile.", "default": "professional" }, "country": { "title": "Country (mode=players)", "enum": [ "", "afghanistan", "albania", "algeria", "antarctica", "argentina", "armenia", "australia", "austria", "bahrain", "bangladesh", "belarus", "belgium", "bermuda", "bolivia", "bosnia-and-herzegovina", "bosnia-herzegovina", "brazil", "british-virgin-islands", "brunei", "bulgaria", "cambodia", "canada", "chile", "china", "chinese-taipei", "colombia", "croatia", "cyprus", "czech-republic", "danmark", "denmark", "egypt", "england", "estonia", "eswatini", "fiji", "finland", "france", "georgia", "germany", "gibraltar", "greece", "guatemala", "guernsey", "hong-kong", "hungary", "iceland", "india", "indonesia", "iran", "iraq", "ireland", "isle-of-man", "israel", "italy", "jamaica", "japan", "jersey", "jordan", "kazakhstan", "kenya", "kosovo", "kuwait", "kyrgyzstan", "laos", "latvia", "lebanon", "libya", "liechtenstein", "lithuania", "luxembourg", "macau", "macedonia", "malaysia", "maldives", "malta", "mauritius", "mexico", "micronesia", "moldova", "monaco", "mongolia", "morocco", "mozambique", "myanmar", "namibia", "nepal", "netherlands", "new-zealand", "nigeria", "northern-ireland", "norway", "oman", "pakistan", "palestine", "panama", "papua-new-guinea", "peru", "philippines", "poland", "portugal", "qatar", "romania", "russia", "samoa", "saudi-arabia", "scotland", "serbia", "singapore", "slovakia", "slovenia", "somalia", "south-africa", "south-korea", "spain", "sri-lanka", "sudan", "suriname", "sweden", "switzerland", "syria", "taiwan", "tanzania", "thailand", "trinidad-and-tobago", "tunisia", "turkey", "turkmenistan", "ukraine", "united-arab-emirates", "united-kingdom", "united-states", "uruguay", "uzbekistan", "venezuela", "vietnam", "wales", "yemen", "zimbabwe" ], "type": "string", "description": "Filter the player directory to one country/nation as CueTracker itself categorizes players (includes UK home nations England/Scotland/Wales/Northern Ireland as separate entries). Leave blank to browse all countries.", "default": "" }, "nameQuery": { "title": "Name contains (mode=players)", "type": "string", "description": "Case-insensitive substring filter on player first/last name. Used by mode=players." }, "tournamentSlug": { "title": "Tournament slug (mode=tournamentResults)", "type": "string", "description": "CueTracker tournament slug (e.g. `world-championship`, `masters`, `uk-championship`, `welsh-open`, `players-championship`) or a full tournament URL. Don't know the slug? Run mode=tournamentsBySeason first to list every tournament (with its slug) played in a given season.", "default": "world-championship" }, "player1Slug": { "title": "Player 1 slug (mode=headToHead)", "type": "string", "description": "First player's CueTracker slug, e.g. `judd-trump`.", "default": "judd-trump" }, "player2Slug": { "title": "Player 2 slug (mode=headToHead)", "type": "string", "description": "Second player's CueTracker slug, e.g. `ronnie-osullivan`.", "default": "ronnie-osullivan" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 25 } } }, "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 } } } } } } } } } }