{"uid":"cap_a2mBbiqdF_zhEP3cl4kSz","slug":"espn-sports-data-scraper-d6364087","name":"ESPN Sports Data Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/espn?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["scoreboard","game","odds","standings","teams","roster","schedule","news","rankings"],"type":"string","default":"scoreboard","description":"Choose scores, game details, odds, standings, teams, rosters, schedules, news, or rankings."},"dates":{"type":"string","description":"One date in YYYYMMDD or YYYY-MM-DD format, today/yesterday/tomorrow, or a YYYYMMDD-YYYYMMDD range up to 32 days."},"groups":{"type":"string","description":"Optional scoreboard group, such as 80 for top-division college football."},"season":{"type":"string","description":"Optional season year for standings, schedules, and rankings."},"leagues":{"type":"array","items":{"type":"string"},"description":"League keys such as nfl, nba, mlb, nhl, college-football, epl, or ucl."},"teamIds":{"type":"array","items":{"type":"string"},"description":"Teams, roster, or schedule mode: league/numeric ID values, such as nba/13."},"eventIds":{"type":"array","items":{"type":"string"},"description":"Game mode: league/id values, such as nfl/401872953."},"startUrls":{"type":"array","items":{"type":"string"},"description":"ESPN game, scoreboard, standings, or team URLs to route automatically."},"maxResults":{"type":"integer","default":200,"minimum":1,"description":"Stop after this many records across the run."},"seasonType":{"type":"string","description":"Optional schedule season type: 1 preseason, 2 regular season, 3 postseason."},"enrichGameDetails":{"type":"boolean","default":false,"description":"Fetch each scoreboard game summary and attach box scores, injuries, and probability when available."},"enrichTeamDetails":{"type":"boolean","default":false,"description":"Open each team profile in Teams mode to include its record and next event."},"includePlayByPlay":{"type":"boolean","default":false,"description":"Include the large play-by-play array in game detail records."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"date":null,"name":null,"type":null,"gameId":null,"league":null,"status":null,"shortName":null,"leagueName":null}],"product":"espn"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gJH9Oe3ybtH6IVCkI0vYn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves structured sports data from ESPN including scoreboards, game details, odds, standings, rosters, schedules, news, and rankings for major leagues","exampleAgentPrompt":"Pull today's NBA scoreboard with full game summaries including box scores and injury reports — I want details for all games, enriched with game details, for up to 200 results.","exampleUseCases":[{"title":"Live NFL scoreboard check","prompt":"What are today's NFL scores? Get me the full scoreboard with game summaries and box scores for all games today."},{"title":"Team roster lookup","prompt":"Can you get me the current roster for the Golden State Warriors from ESPN? Their NBA team ID is nba/9."},{"title":"College football rankings","prompt":"Pull the latest college football rankings for this season — specifically the top-division group 80, for the 2024 season."}],"resultDescription":"Returns a JSON object with a count of records and an items array, where each item contains fields such as date, name, type, gameId, league, status, shortName, and leagueName. When enrichment options are enabled, items may also include box scores, injury data, game probability, play-by-play arrays, team records, and next event info.","failureModes":["Invalid league key returns empty results or error","Date format not matching YYYYMMDD or YYYY-MM-DD causes parsing failure","Date range exceeding 32 days is rejected","Invalid teamId or eventId format returns no items","Mode/league combination not supported returns empty items array","ESPN source unavailable or rate-limited causes failed run (not charged)","Empty run due to no matching data returns count 0 and is not billed"],"whenToPreferThis":"Choose this endpoint when you need structured, parsed ESPN sports data without building a scraper yourself, especially for multi-league queries, enriched game details with box scores and injuries, or flexible date-range scoreboards. Prefer it over raw web scraping when you want clean JSON output with consistent schema across NFL, NBA, MLB, NHL, college football, EPL, and UCL. It is pay-per-successful-call so failed or empty runs are free.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:53.194Z","isFirstParty":false,"canonicalSlug":"espn-sports-data-scraper-d6364087"}