{ "openapi": "3.0.1", "info": { "title": "Sofascore Tennis Tournaments Scraper", "description": "Export SofaScore tennis tournament metadata, current title holders, most-title records, season IDs, and chronological season matches for recurring tournament analysis.", "version": "0.1", "x-build-id": "XpxO2cTJENgeqeIzK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~sofascore-tennis-tournaments/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-sofascore-tennis-tournaments", "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/automation-lab~sofascore-tennis-tournaments/runs": { "post": { "operationId": "runs-sync-automation-lab-sofascore-tennis-tournaments", "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/automation-lab~sofascore-tennis-tournaments/run-sync": { "post": { "operationId": "run-sync-automation-lab-sofascore-tennis-tournaments", "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": { "tournamentIds": { "title": "Unique tournament IDs", "minItems": 1, "maxItems": 100, "type": "array", "description": "SofaScore tennis unique tournament IDs, not individual match or tournament-group IDs. Duplicates are removed in input order. Defaults to Australian Open men (2363). Up to 100 supplied IDs; maxItems limits exported bundles. Non-tennis or unknown IDs fail the run.", "items": { "type": "integer", "minimum": 1 }, "default": [ 2363 ] }, "seasonId": { "title": "Season ID (optional)", "minimum": 1, "type": "integer", "description": "Exact season ID listed for the tournament. Requires exactly one unique tournament ID and includeMatches=true; incompatible combinations fail. If omitted, the first season in SofaScore's season index is selected. This does not change the current title holder into a historical champion." }, "includeMatches": { "title": "Include season matches", "type": "boolean", "description": "Fetch finished and upcoming match pages for the selected season, deduplicate by match ID and sort by UTC start time then match ID. False exports only tournament metadata and season IDs, with no selectedSeason or match fetches; seasonId is then rejected. No bracket topology or champion archive is returned.", "default": true }, "maxMatches": { "title": "Maximum matches per tournament", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum nested match objects per tournament bundle, default 200, range 1–1000 (zero is invalid). All available pages are fetched before the earliest chronological matches are retained; totalMatchesAvailable and matchesTruncated disclose truncation. Ignored when includeMatches=false. A source safety ceiling of 40 pages per direction fails rather than claiming a complete export.", "default": 200 }, "maxItems": { "title": "Maximum tournament bundles", "minimum": 1, "maximum": 100, "type": "integer", "description": "Global maximum top-level tournament results for this run, default 1, range 1–100; not a match count. Applied to the deduplicated IDs in input order before any requests. IDs beyond this limit are not processed. Zero/unlimited is not supported.", "default": 1 } } }, "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 } } } } } } } } } }