{"uid":"cap_SMUPWQ200dLcUosspdk2b","slug":"espn-soccer-scoreboard-by-league-date-66dd4850","name":"ESPN Soccer Scoreboard by League & Date","description":"ESPN soccer scoreboard for one league and date: each match with home and away team, score, status (scheduled, live, full time) and stadium, from ESPN's public site JSON. Default league is the English Premier League (eng.1); times are UTC.","url":"https://api.fadeandco.workers.dev/api/dev/espn-soccer-scoreboard?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":{"date":{"type":"string","description":"Date YYYY-MM-DD (default: yesterday UTC)"},"league":{"type":"string","description":"ESPN league code, e.g. eng.1, esp.1, ger.1, ita.1, fra.1, uefa.champions (default eng.1)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"date":"2026-10-17","count":5,"league":"eng.1","source":"https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/scoreboard?dates=20261017","matches":[{"id":"401878771","away":{"name":"Chelsea","score":2,"abbreviation":"CHE"},"home":{"name":"Everton","score":0,"abbreviation":"EVE"},"name":"Chelsea at Everton","state":"post","venue":"Hill Dickinson Stadium","status":"FT","startUtc":"2026-10-17T11:30Z"},{"id":"401879262","away":{"name":"Liverpool","score":2,"abbreviation":"LIV"},"home":{"name":"Brentford","score":1,"abbreviation":"BRE"},"name":"Liverpool at Brentford","state":"post","venue":"Gtech Community Stadium","status":"FT","startUtc":"2026-10-17T14:00Z"}],"checkedAt":"2026-10-23T09:35:26.283Z","league_name":"English Premier League"}},"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_e5xSp8SqtMAuRHIBM9_Gd","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 match results and live scores for a given soccer league and date from ESPN's public scoreboard API, including teams, scores, status, and venue.","exampleAgentPrompt":"What were all the Premier League scores yesterday? I want to see the home and away teams, final scores, and stadiums for each match.","exampleUseCases":[{"title":"Live match status during a game day","prompt":"Can you pull up the live scores for all Champions League matches happening today? I want to know the current score and status for each game."},{"title":"Post-match results recap","prompt":"What were the results for all Serie A matches on October 17th, 2026? Show me the teams, scores, and venues."},{"title":"Automated daily soccer digest","prompt":"Every morning, give me yesterday's English Premier League results — teams, scores, and match status — so I can see what I missed."}],"resultDescription":"A JSON object containing the date, league code, league name, match count, and an array of matches each with home/away team names, abbreviations, scores, match state (pre/in/post), human-readable status (e.g. FT, LIVE), venue name, match start time in UTC, and the ESPN source URL. Also includes a checkedAt timestamp.","failureModes":["Invalid league code returns an empty matches array or error","Future dates with no scheduled matches return count:0 and empty matches array","Malformed date format may return an error or fall back to default date","ESPN upstream API unavailability causes proxy failure","Dates far in the future may have no data yet"],"whenToPreferThis":"Use this endpoint when you need quick, structured soccer match data (scores, status, venue) for a specific league and date sourced from ESPN's public API, without needing authentication. Prefer this over scraping ESPN directly or using paid sports data APIs when ESPN's public feed suffices and the supported leagues (Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League) cover your need.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:19.804Z","isFirstParty":false,"canonicalSlug":"espn-soccer-scoreboard-by-league-date-66dd4850"}