{ "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": "b23cTrTzeFTmdVJkx" }, "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. Two modes need one extra field: \"Matches of a player\" needs Player IDs, and \"Find a player\" needs a Player name. Everything else runs as it is.", "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 — required for \"Matches of a player\"", "type": "array", "description": "Numeric player IDs. Run \"Find a player\" first to look one up — searching for Alcaraz returns ID 52602. Ignored in every other mode.", "items": { "type": "string" } }, "searchQuery": { "title": "Player name — required for \"Find a player\"", "type": "string", "description": "Name or part of a name, e.g. Alcaraz. Ignored in every other 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", "pattern": "^$|^\\d{4}$", "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", "pattern": "^$|^\\d{4}$|^\\d{4}-\\d{2}-\\d{2}([T ].*)?$|^\\d{2}[-./]\\d{2}[-./]\\d{4}$|^\\d{9,}$", "type": "string", "description": "Historical rankings for one specific date, e.g. 2024-06-10. Applies to the world rankings mode only. Leave empty for the current ranking." }, "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 } } } } } } } } } }