{
  "openapi": "3.0.1",
  "info": {
    "title": "League Standings & Top Scorers Scraper — ATP, WTA",
    "description": "League tables, season scoring charts and tennis rankings in one Actor: rank, form, goals, points, qualification zones, next fixture, top scorers with club and nationality, ATP and WTA rankings with points and position change, tennis Elo by surface. No login, no browser.",
    "version": "1.0",
    "x-build-id": "V8RynxFHnD3oaxMeN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scapypuppy~league-standings-top-scorers/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scapypuppy-league-standings-top-scorers",
        "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/scapypuppy~league-standings-top-scorers/runs": {
      "post": {
        "operationId": "runs-sync-scapypuppy-league-standings-top-scorers",
        "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/scapypuppy~league-standings-top-scorers/run-sync": {
      "post": {
        "operationId": "run-sync-scapypuppy-league-standings-top-scorers",
        "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": {
          "leagueUrls": {
            "title": "League pages",
            "type": "array",
            "description": "Pick popular leagues from the list or paste any Flashscore league page of any sport, like https://www.flashscore.com/football/italy/serie-a/.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "https://www.flashscore.com/football/england/premier-league/",
                "https://www.flashscore.com/football/spain/laliga/",
                "https://www.flashscore.com/football/italy/serie-a/",
                "https://www.flashscore.com/football/germany/bundesliga/",
                "https://www.flashscore.com/football/france/ligue-1/",
                "https://www.flashscore.com/football/europe/champions-league/",
                "https://www.flashscore.com/football/england/championship/",
                "https://www.flashscore.com/football/netherlands/eredivisie/",
                "https://www.flashscore.com/football/portugal/liga-portugal/",
                "https://www.flashscore.com/football/usa/mls/",
                "https://www.flashscore.com/basketball/usa/nba/",
                "https://www.flashscore.com/basketball/europe/euroleague/",
                "https://www.flashscore.com/hockey/usa/nhl/",
                "https://www.flashscore.com/baseball/usa/mlb/"
              ],
              "enumTitles": [
                "Football - England: Premier League",
                "Football - Spain: LaLiga",
                "Football - Italy: Serie A",
                "Football - Germany: Bundesliga",
                "Football - France: Ligue 1",
                "Football - Europe: Champions League",
                "Football - England: Championship",
                "Football - Netherlands: Eredivisie",
                "Football - Portugal: Liga Portugal",
                "Football - USA: MLS",
                "Basketball - USA: NBA",
                "Basketball - Europe: Euroleague",
                "Hockey - USA: NHL",
                "Baseball - USA: MLB"
              ]
            }
          },
          "rankingUrls": {
            "title": "Ranking pages",
            "type": "array",
            "description": "Tennis rankings from the list: ATP and WTA singles, doubles and the Race of each, eight in all. A ranking page pasted from flashscore.com works too. Rankings appear under Output, Rankings.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "https://www.flashscore.com/tennis/rankings/atp/",
                "https://www.flashscore.com/tennis/rankings/wta/",
                "https://www.flashscore.com/tennis/rankings/atp-race/",
                "https://www.flashscore.com/tennis/rankings/wta-race/",
                "https://www.flashscore.com/tennis/rankings/atp-doubles/",
                "https://www.flashscore.com/tennis/rankings/wta-doubles/",
                "https://www.flashscore.com/tennis/rankings/atp-doubles-race/",
                "https://www.flashscore.com/tennis/rankings/wta-doubles-race/"
              ],
              "enumTitles": [
                "ATP singles",
                "WTA singles",
                "ATP Race (singles)",
                "WTA Race (singles)",
                "ATP doubles",
                "WTA doubles",
                "ATP doubles Race",
                "WTA doubles Race"
              ]
            }
          },
          "includeStandings": {
            "title": "League table",
            "type": "boolean",
            "description": "Rank, played, wins, draws, losses, goals, points, form, qualification zone and next fixture per team. Off-season tables give a note, not billed.",
            "default": true
          },
          "includeHomeAwayTables": {
            "title": "Home and away tables",
            "type": "boolean",
            "description": "Two more tables built only from home matches and only from away matches. One request each; rows are billed like the main table.",
            "default": false
          },
          "tableTypes": {
            "title": "Extra tables",
            "type": "array",
            "description": "Form, Over/Under and HT/FT tables, one request each per league, rows billed like the main table. One type can hold several tables (see README).",
            "items": {
              "type": "string",
              "enum": [
                "form",
                "form-home",
                "form-away",
                "over-under",
                "over-under-home",
                "over-under-away",
                "ht-ft",
                "ht-ft-home",
                "ht-ft-away"
              ],
              "enumTitles": [
                "Form",
                "Form, home matches",
                "Form, away matches",
                "Over/Under",
                "Over/Under, home matches",
                "Over/Under, away matches",
                "HT/FT",
                "HT/FT, home matches",
                "HT/FT, away matches"
              ]
            },
            "default": []
          },
          "overUnderLines": {
            "title": "Over/Under lines",
            "type": "array",
            "description": "Keep only these total lines of the Over/Under tables, like 2.5. Each line is a separate billed table (the Premier League has seven); empty keeps all. No extra request.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "formWindows": {
            "title": "Form windows",
            "type": "array",
            "description": "Keep only these Form tables, by the number of latest matches: 5, 10. Each window is a separate billed table; empty keeps all. No extra request.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeTopScorers": {
            "title": "Top scorers",
            "type": "boolean",
            "description": "Season scoring chart: player, club, goals, position and nationality, with links to both profiles.",
            "default": true
          },
          "maxTopScorers": {
            "title": "Max top scorers per league",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many rows of the scoring chart to keep. Billed per row, so this is also a cost cap.",
            "default": 50
          },
          "lastSeasons": {
            "title": "Last seasons",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many seasons to return, newest first, counting back from the season the league page opens on: 3 gives it and the two before it. Each season is billed as a league."
          },
          "seasons": {
            "title": "Seasons",
            "type": "array",
            "description": "Seasons by name, as the source writes them: 2024/2025 in football, 2025 in MLB (2024-25 works too). Adds to Last seasons; a season the league does not have is named in the status with the nearest ones.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeEloRankings": {
            "title": "Elo ratings (Tennis Abstract)",
            "type": "boolean",
            "description": "Tennis Elo leaderboards: overall Elo plus hard, clay and grass ratings, age, peak Elo and the official rank next to the Elo rank. One request per tour.",
            "default": false
          },
          "eloTours": {
            "title": "Elo tours",
            "type": "array",
            "description": "Which tours to fetch Elo ratings for, when Elo ratings are on. Empty means both.",
            "items": {
              "type": "string",
              "enum": [
                "atp",
                "wta"
              ],
              "enumTitles": [
                "ATP (men)",
                "WTA (women)"
              ]
            },
            "default": [
              "atp",
              "wta"
            ]
          },
          "maxRankingRows": {
            "title": "Max ranking rows",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many players to keep from each ranking table, Elo tables included. Billed per row, so this is also a cost cap: the ATP singles table has about 2,300 rows.",
            "default": 100
          },
          "onlyChanges": {
            "title": "Only new and changed rows",
            "type": "boolean",
            "description": "Return and bill only the rows that are new or changed since the last run with the same changes name; a league or ranking without changes gives no record. The first run returns everything.",
            "default": false
          },
          "changesName": {
            "title": "Changes name",
            "type": "string",
            "description": "Name of the memory of the option above, the store standings-changes-<name>, kept until you delete it; empty means default. Use one name per schedule, and never run two runs with one name at once."
          },
          "changesKey": {
            "title": "Changes key (older name)",
            "type": "string",
            "description": "Older name of Changes name, kept hidden so saved tasks keep their memory; Changes name wins when both are set."
          },
          "outputLayout": {
            "title": "Output layout",
            "enum": [
              "nested",
              "rows"
            ],
            "type": "string",
            "description": "Nested: one record per league or ranking, rows inside it; the League tables, Top scorers and Rankings views still show one row each. Rows: one record per table row with a recordType field, ready for CSV. Billing is the same.",
            "default": "nested"
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "The first requests go out directly, which is faster; this proxy takes over after about 140 requests or when the source refuses a direct one. Datacenter proxies are enough.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}