{ "openapi": "3.0.1", "info": { "title": "Tennis Scraper — ATP Rankings, Elo & Matches", "description": "ATP rankings and Elo ratings, full player match histories with surface, round, tier and score, plus tournament results with field strength. Surfaces and tiers in plain words, not letter codes. No API key. For betting analytics, fantasy sports and sports media.", "version": "0.1", "x-build-id": "dN9TzZ1mQADn4Yd6V" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datawell~tennis-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datawell-tennis-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/datawell~tennis-scraper/runs": { "post": { "operationId": "runs-sync-datawell-tennis-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/datawell~tennis-scraper/run-sync": { "post": { "operationId": "run-sync-datawell-tennis-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": "What to scrape", "enum": [ "rankings", "playerMatches", "tournaments", "searchPlayers" ], "type": "string", "description": "Pick what you want to collect. The fields below apply depending on this choice.", "default": "rankings" }, "rankingType": { "title": "Ranking type", "enum": [ "RANK", "ELO_RANK" ], "type": "string", "description": "Official rankings follow the tour's points system. Elo ratings measure actual strength and predict matches better.", "default": "RANK" }, "playerIds": { "title": "Player IDs", "type": "array", "description": "Numeric player IDs. Use the 'Find a player' mode first to look them up.", "items": { "type": "string" } }, "searchQuery": { "title": "Player name", "type": "string", "description": "Name or part of a name, e.g. 'Alcaraz'. Used in the player search mode." }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Total number of records to collect. With several players, the budget is split evenly between them.", "default": 100 }, "season": { "title": "Season", "type": "string", "description": "Restrict to one year, e.g. 2024. Leave empty for all seasons." }, "surface": { "title": "Surface", "enum": [ "", "H", "C", "G", "P" ], "type": "string", "description": "Only matches or tournaments on this surface.", "default": "" }, "level": { "title": "Tournament level", "enum": [ "", "G", "F", "M", "O", "A", "B", "D", "C" ], "type": "string", "description": "Only matches or tournaments at this level.", "default": "" }, "rankingDate": { "title": "Rankings as of date", "type": "string", "description": "Historical rankings for a specific date, format 2024-06-10. Leave empty for current." }, "requestDelaySeconds": { "title": "Delay between requests", "minimum": 0, "maximum": 10, "type": "integer", "description": "Seconds to wait between calls. Raise this for very large runs.", "default": 0 } } }, "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 } } } } } } } } } }