{ "openapi": "3.0.1", "info": { "title": "WTA Tennis Rankings Scraper", "description": "WTA Tennis Rankings Scraper reads the WTA's own published ranking tables and returns one row per player: rank, week-on-week movement, points, country, age and tournaments played. Singles, doubles and both Race tables. onlyChangedSinceLastRun defaults ON, so a daily run bills only movers.", "version": "0.1", "x-build-id": "aLrtqcuk8Kkr0VFld" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/praise-most-high~wta-tennis-rankings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-praise-most-high-wta-tennis-rankings-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/praise-most-high~wta-tennis-rankings-scraper/runs": { "post": { "operationId": "runs-sync-praise-most-high-wta-tennis-rankings-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/praise-most-high~wta-tennis-rankings-scraper/run-sync": { "post": { "operationId": "run-sync-praise-most-high-wta-tennis-rankings-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": [ "rankingTypes" ], "properties": { "rankingTypes": { "title": "WTA ranking tables", "type": "array", "description": "Which of the WTA's four published ranking tables to read: singles, doubles, race-singles, race-doubles. Each table publishes its top 50 players. The two Race tables are empty outside the season — an empty table is reported as empty and is never charged.", "items": { "type": "string" } }, "maxPlayersPerTable": { "title": "Max players per table", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cap on players returned per ranking table. The WTA publishes 50 per table and no more, so 50 is both the default and the ceiling — a higher number returns 50, it does not reach deeper into the rankings.", "default": 50 }, "onlyChangedSinceLastRun": { "title": "Only players whose ranking changed since your last run", "type": "boolean", "description": "ON BY DEFAULT, and leaving it on is what keeps a scheduled run cheap. A player is returned only when their rank or their points have moved since you last received them. WTA rankings update once a week, so on a daily schedule this is the difference between paying for 50 rows a day and paying for the handful that actually moved. Turn it off only when you deliberately want the full table again.", "default": true }, "maxRank": { "title": "Only players ranked this high or better", "minimum": 1, "maximum": 50, "type": "integer", "description": "Keep only players whose rank is this number or lower — 10 gives you the top ten. Leave empty for the whole published table. The filter runs BEFORE charging, so narrowing it lowers your bill." }, "countryCodes": { "title": "Only these countries", "type": "array", "description": "Three-letter country codes as the WTA publishes them, for example USA, POL, BLR. Leave empty for every country. This filter also runs before charging, so it lowers your bill rather than raising it.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }