{"uid":"cap_kP3yKyakO-jLu_-GpbzmR","slug":"understat-xg-player-stats-716ad0f3","name":"Understat xG Player Stats","description":"Understat expected-goals (xG) player stats for one league and season: top players by xG with goals, xG, assists, xA, shots, key passes and minutes. Leagues: EPL, La_liga, Bundesliga, Serie_A, Ligue_1, RFPL. Season is the start year (2025 = 2025-26).","url":"https://api.fadeandco.workers.dev/api/dev/understat-xg?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"limit":{"type":"string","description":"How many players, 1 to 50 (default 10)"},"league":{"type":"string","description":"EPL (default), La_liga, Bundesliga, Serie_A, Ligue_1 or RFPL"},"season":{"type":"string","description":"Season start year, 2014 to 2026 (default 2025)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XL-pnj2ePV7CtU2ZtoKWd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns top players by expected goals (xG) for a given football league and season, including goals, xG, assists, xA, shots, key passes, and minutes played.","exampleAgentPrompt":"Can you pull the top 25 Premier League players by expected goals for the 2024-25 season from Understat, including their actual goals, assists, xA, shots, key passes, and minutes?","exampleUseCases":[{"title":"Fantasy football xG analysis","prompt":"Get me the top 20 EPL players by expected goals for the 2025 season — I want to see their actual goals versus xG so I can spot who's overperforming or underperforming for my fantasy team."},{"title":"Bundesliga attacking talent scouting","prompt":"Pull the top 15 Bundesliga players by xG for the 2023 season, including their assists and key passes — I'm trying to identify the best creative attackers."},{"title":"Serie A season-end xG review","prompt":"Show me the top 10 Serie A players ranked by expected goals for the 2022 season, with their shots and minutes played so I can assess who had the most dangerous performances."}],"resultDescription":"A ranked list of players (up to the requested limit) from the specified league and season, each with their name, goals scored, xG, assists, xA, shot count, key passes, and minutes played — sourced from Understat data.","failureModes":["Invalid league name returns an error or empty result","Season year outside 2014–2026 range may return an error","Limit outside 1–50 range may be rejected or clamped","Understat source unavailable causes upstream fetch failure","Very recent season data may be incomplete or missing"],"whenToPreferThis":"Use this endpoint when you need structured, per-player xG and xA statistics for a specific European football league and season. It is the right choice when the goal is to rank or compare players by expected performance metrics rather than just raw goals. Prefer this over general sports APIs when Understat's model-based xG data is specifically required for analysis, scouting, or fantasy football purposes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:32:47.715Z","isFirstParty":false,"canonicalSlug":"understat-xg-player-stats-716ad0f3"}