{ "openapi": "3.0.1", "info": { "title": "Tennis Elo Ratings Scraper - ATP & WTA Surface Elo, Win Odds", "description": "For tennis bettors and model builders: Tennis Abstract Elo for every ATP and WTA player - overall, hard, clay and grass Elo with ranks, peak Elo, official rank - plus matchup win probability. 1,083 players in the 14 Sep 2026 update. Price matches on surface Elo without your own model.", "version": "0.1", "x-build-id": "SjL2MKEvkRExSOdJF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~tennis-elo-ratings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-tennis-elo-ratings-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/neverempty~tennis-elo-ratings-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-tennis-elo-ratings-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/neverempty~tennis-elo-ratings-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-tennis-elo-ratings-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": { "tours": { "title": "Tours", "type": "array", "description": "Which Elo lists to return: ATP (men) and/or WTA (women). Leave empty for both.", "items": { "type": "string", "enum": [ "atp", "wta" ], "enumTitles": [ "ATP (men)", "WTA (women)" ] } }, "maxPlayersPerTour": { "title": "Players per tour", "minimum": 0, "maximum": 5000, "type": "integer", "description": "How many players to return from the top of each Elo list. 0 returns every player (553 ATP and 530 WTA in the 14 Sep 2026 update). Ignored when you list players by name, and not used when you enter matchups unless 'Also return rankings' is ticked.", "default": 50 }, "players": { "title": "Only these players", "type": "array", "description": "Return only these players, one per line: full name (Jannik Sinner), last name when it is unique (Sinner), Tennis Abstract id (JannikSinner) or player page URL. Accents and case do not matter (iga świątek finds Iga Swiatek). A name that matches several players or none comes back as a free row that says so.", "items": { "type": "string" } }, "includeProfile": { "title": "Add player profiles", "type": "boolean", "description": "Also open each player's Tennis Abstract page and add current and best official rank, date the best rank was first and last held, date of birth, height, playing hand, backhand, country and active flag. Slower: Tennis Abstract is an independent site, so pages are read one at a time at least 3 seconds apart (about 5 seconds per player; 100 players take about 8 minutes). Match histories are not included.", "default": false }, "matchups": { "title": "Matchups (win probability)", "type": "array", "description": "Pairs of players to compare, one per line, written as \"Player A vs Player B\". Add \"| clay\", \"| hard\", \"| grass\" or \"| overall\" at the end to choose the surface for that line. Each line returns Player A's and Player B's Elo, win probability from the standard Elo formula 1 / (1 + 10^((EloB - EloA) / 400)), and fair decimal odds. Both players must be on the same tour. When you enter matchups, only matchup rows are returned unless you tick 'Also return rankings'.", "items": { "type": "string" } }, "surface": { "title": "Matchup surface", "enum": [ "overall", "hard", "clay", "grass" ], "type": "string", "description": "Surface used for matchups that do not name one: overall Elo, or the hard, clay or grass Elo.", "default": "overall" }, "alsoReturnRankings": { "title": "Also return rankings", "type": "boolean", "description": "With matchups entered, also return the ranking rows chosen above (tours, players per tour, only these players).", "default": 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 } } } } } } } } } }