EuroLeague & EuroCup games, box scores and players

Pull structured basketball data for the EuroLeague and the EuroCup from the public Euroleague Basketball JSON API: fixtures and results, league tables, player-by-player box scores, rosters with season statistics, and club details. No login or API key is involved and only publicly available data is read.

Modes

Choose one with the mode input. Every mode honors maxItems. If a request fails or an input does not match anything, the Actor writes a row with "error": true and a message, and carries on; those rows are not billed.

schedule

One row per game: round, date, teams, scores, quarter scores, venue, referees and status.

{ "mode": "schedule", "competition": "E", "season": "2025", "round": 1, "status": "finished", "maxItems": 20 }

Optional filters: round, teamCode, status (all / finished / scheduled), dateFrom, dateTo.

standings

League table rows (one per club). Without round the latest round that has a published table is used.

{ "mode": "standings", "competition": "E", "season": "2025", "round": 20 }

boxscore

One row per player per game, with team and game context. Pick games by gameCodes, or leave it empty and use round, teamCode, dateFrom, dateTo (finished games only, oldest first). Players with zero minutes are skipped unless includeDidNotPlay is true.

{ "mode": "boxscore", "competition": "E", "season": "2025", "gameCodes": [1, 2], "maxItems": 100 }

players

Every rostered player of the season (optionally for one teamCode) with bio data and season statistics. statsMode is accumulated (season totals) or perGame (averages derived from the totals).

{ "mode": "players", "competition": "U", "season": "2025", "teamCode": "BAS", "statsMode": "perGame" }

teams

One row per club taking part in the season: names, country, city, arena code, president, website, social handle, crest image.

{ "mode": "teams", "competition": "E", "season": "2025" }

Common inputs

Field	Meaning
competition	E = EuroLeague, U = EuroCup
season	Start year, 2025 means 2025-26 (E2025 also accepted)
maxItems	Cap on result rows (default 50)
maxConcurrency	1 to 3 parallel box score requests (default 2)

Output fields

Every row carries competition and season.

Mode	Fields
schedule	gameCode, gameId, round, roundName, phase, group, status, dateLocal, dateUtc, homeTeamCode, homeTeam, awayTeamCode, awayTeam, homeScore, awayScore, winnerCode, homeQuarters, awayQuarters, overtimePeriods, venue, venueCapacity, neutralVenue, attendance, referees
standings	round, group, phaseCode, position, teamCode, team, country, gamesPlayed, wins, losses, winPct, pointsFor, pointsAgainst, pointDifference, qualified
boxscore	gameCode, round, phase, dateLocal, homeTeam, awayTeam, homeScore, awayScore, teamCode, team, opponentCode, opponent, isHome, playerCode, playerName, jersey, position, starter, played, minutes, minutesText, points, fieldGoalsMade/Attempted/Pct, twoPointsMade/Attempted, threePointsMade/Attempted/Pct, freeThrowsMade/Attempted/Pct, offensiveRebounds, defensiveRebounds, totalRebounds, assists, steals, blocks, blocksAgainst, turnovers, foulsCommitted, foulsDrawn, plusMinus, valuation
players	playerCode, name, teamCode, team, jersey, position, heightCm, weightKg, birthDate, age, country, active, photoUrl, statsMode, gamesPlayed, gamesStarted, minutes, points, two/three-point and free-throw made/attempted/pct, rebounds, assists, steals, blocks, turnovers, foulsCommitted, foulsDrawn, valuation
teams	teamCode, name, shortName, editorialName, tvCode, country, city, address, venueCode, president, phone, website, ticketsUrl, twitter, crestUrl
error rows	error (true), mode, message, plus gameCode or round when relevant

valuation is the official performance index rating (PIR). Field-goal figures in box scores are totals (twos plus threes); blocks are shots the player blocked, blocksAgainst shots of his that were blocked.

Notes and limitations

• Round numbers run through the whole season (regular season, playoffs, Final Four), so playoff games have rounds above the regular-season count.
• Box scores exist only for games that have been played. Early-season or very recent games may be missing until the league publishes them.
• Season statistics in players mode come from the league's season totals; players who changed clubs may show the combined line on their listed club.
• Standings tables are published per round; an unplayed round returns an error row.
• Requests are throttled (at most 3 at once, small random pauses, retries with backoff on rate limits and server errors). Data belongs to its publisher and is provided as found.