{
  "description": "Scrape live scores, fixtures, standings, team/player profiles, match details and rankings from SofaScore across 25 sports. No login or API key.",
  "properties": {
    "date": {
      "description": "Start date for fixtures (mode=scheduled), format YYYY-MM-DD. Defaults to today UTC.",
      "editor": "datepicker",
      "title": "Date",
      "type": "string"
    },
    "daysAhead": {
      "default": 0,
      "description": "Number of extra days after Date to include (mode=scheduled).",
      "maximum": 31,
      "minimum": 0,
      "prefill": 0,
      "title": "Days Ahead",
      "type": "integer"
    },
    "eventIds": {
      "description": "SofaScore match IDs or match page URLs (mode=event).",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Match IDs or URLs",
      "type": "array"
    },
    "includeAdvanced": {
      "default": false,
      "description": "Add shotmap, momentum, average positions, best players, win probability, managers, streaks and pre-game form.",
      "prefill": false,
      "title": "Include Advanced Match Data",
      "type": "boolean"
    },
    "includeComments": {
      "default": false,
      "description": "Add the text commentary feed to match records. This is a large payload.",
      "prefill": false,
      "title": "Include Commentary",
      "type": "boolean"
    },
    "includeEvents": {
      "default": false,
      "description": "Add recent and upcoming events to team records (mode=team).",
      "prefill": false,
      "title": "Include Team Events",
      "type": "boolean"
    },
    "includeH2h": {
      "default": false,
      "description": "Add head-to-head win/draw tallies to match records.",
      "prefill": false,
      "title": "Include Head-to-Head",
      "type": "boolean"
    },
    "includeIncidents": {
      "default": true,
      "description": "Add goals, cards and substitutions to match records.",
      "prefill": false,
      "title": "Include Incidents",
      "type": "boolean"
    },
    "includeLineups": {
      "default": true,
      "description": "Add lineups, formations and player ratings to match records.",
      "prefill": false,
      "title": "Include Lineups",
      "type": "boolean"
    },
    "includeOdds": {
      "default": false,
      "description": "Add pre-match odds markets to match records.",
      "prefill": false,
      "title": "Include Odds",
      "type": "boolean"
    },
    "includePlayerStats": {
      "default": false,
      "description": "Add per-competition season statistics to player records (mode=player).",
      "prefill": false,
      "title": "Include Player Statistics",
      "type": "boolean"
    },
    "includeSquad": {
      "default": false,
      "description": "Add the full squad to team records (mode=team).",
      "prefill": false,
      "title": "Include Squad",
      "type": "boolean"
    },
    "includeStandings": {
      "default": false,
      "description": "Add the league table to tournament records (mode=tournament).",
      "prefill": false,
      "title": "Include Standings",
      "type": "boolean"
    },
    "includeStatistics": {
      "default": true,
      "description": "Add team and player statistics to match records.",
      "prefill": false,
      "title": "Include Statistics",
      "type": "boolean"
    },
    "includeVotes": {
      "default": false,
      "description": "Add crowd prediction polls to match records.",
      "prefill": false,
      "title": "Include Votes",
      "type": "boolean"
    },
    "maxItems": {
      "default": 50,
      "description": "Maximum number of records to return. 0 means no user limit (hard cap 10,000).",
      "maximum": 10000,
      "minimum": 0,
      "prefill": 3,
      "title": "Max Items",
      "type": "integer"
    },
    "mode": {
      "default": "search",
      "description": "What to fetch from SofaScore.",
      "editor": "select",
      "enum": [
        "search",
        "live",
        "scheduled",
        "team",
        "player",
        "tournament",
        "standings",
        "event",
        "rankings"
      ],
      "enumTitles": [
        "Search by name",
        "Live events",
        "Fixtures by date",
        "Team profile",
        "Player profile",
        "Tournament profile",
        "League standings",
        "Match details by ID or URL",
        "Rankings"
      ],
      "prefill": "search",
      "title": "Mode",
      "type": "string"
    },
    "playerIds": {
      "description": "SofaScore player IDs or player page URLs (mode=player).",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Player IDs or URLs",
      "type": "array"
    },
    "rankingType": {
      "default": "fifa",
      "description": "Ranking table to fetch (mode=rankings).",
      "editor": "select",
      "enum": [
        "uefa-countries",
        "fifa",
        "rugby-union",
        "rugby-league",
        "atp",
        "wta",
        "atp-live",
        "wta-live",
        "uefa-clubs",
        "ufc-flyweight",
        "ufc-bantamweight",
        "ufc-featherweight",
        "ufc-lightweight",
        "ufc-welterweight",
        "ufc-middleweight",
        "ufc-light-heavyweight",
        "ufc-heavyweight",
        "ufc-womens-strawweight",
        "ufc-womens-flyweight",
        "ufc-womens-bantamweight",
        "ufc-womens-featherweight",
        "utr-men",
        "utr-women",
        "fip-men",
        "fip-women",
        "fnc-bantamweight",
        "fnc-featherweight",
        "fnc-lightweight",
        "fnc-welterweight",
        "fnc-middleweight",
        "fnc-light-heavyweight"
      ],
      "enumTitles": [
        "UEFA Countries",
        "FIFA Rankings",
        "Rugby Union Rankings",
        "Rugby League Rankings",
        "ATP Rankings",
        "WTA Rankings",
        "ATP Rankings Live",
        "WTA Rankings Live",
        "UEFA Clubs",
        "UFC Flyweight",
        "UFC Bantamweight",
        "UFC Featherweight",
        "UFC Lightweight",
        "UFC Welterweight",
        "UFC Middleweight",
        "UFC Light Heavyweight",
        "UFC Heavyweight",
        "UFC Women's Strawweight",
        "UFC Women's Flyweight",
        "UFC Women's Bantamweight",
        "UFC Women's Featherweight",
        "UTR Men",
        "UTR Women",
        "FIP Ranking Men",
        "FIP Ranking Women",
        "FNC Bantamweight",
        "FNC Featherweight",
        "FNC Lightweight",
        "FNC Welterweight",
        "FNC Middleweight",
        "FNC Light Heavyweight"
      ],
      "prefill": "fifa",
      "title": "Ranking Type",
      "type": "string"
    },
    "searchQueries": {
      "description": "Team, player, tournament or match names to resolve (mode=search).",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "Real Madrid"
      ],
      "title": "Search Queries",
      "type": "array"
    },
    "searchType": {
      "default": "all",
      "description": "Restrict search results to one entity type (mode=search).",
      "editor": "select",
      "enum": [
        "all",
        "team",
        "player",
        "tournament",
        "event"
      ],
      "enumTitles": [
        "All types",
        "Teams",
        "Players",
        "Tournaments",
        "Matches"
      ],
      "prefill": "all",
      "title": "Search Result Type",
      "type": "string"
    },
    "seasonId": {
      "description": "Optional season ID for standings or tournament mode. If omitted, the latest season with a table is used.",
      "minimum": 1,
      "title": "Season ID",
      "type": "integer"
    },
    "sports": {
      "default": [
        "football"
      ],
      "description": "Sports for live and scheduled modes. Supported: football, basketball, tennis, american-football, aussie-rules, ice-hockey, handball, rugby, futsal, minifootball, floorball, volleyball, badminton, table-tennis, padel, snooker, baseball, cricket, esports, darts, mma, cycling, motorsport, waterpolo, bandy.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "prefill": [
        "football"
      ],
      "title": "Sports",
      "type": "array"
    },
    "tableType": {
      "default": "total",
      "description": "Standings table to fetch (modes standings, tournament).",
      "editor": "select",
      "enum": [
        "total",
        "home",
        "away"
      ],
      "enumTitles": [
        "Overall",
        "Home",
        "Away"
      ],
      "prefill": "total",
      "title": "Table Type",
      "type": "string"
    },
    "teamIds": {
      "description": "SofaScore team IDs or team page URLs (mode=team).",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Team IDs or URLs",
      "type": "array"
    },
    "tournamentIds": {
      "description": "SofaScore unique-tournament IDs or tournament page URLs (modes tournament, standings).",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Tournament IDs or URLs",
      "type": "array"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "SofaScore Scraper Input",
  "type": "object"
}