{"uid":"cap_VsXcqHr8c0txs2C6UN_Vs","slug":"sports-game-brief-api-nba-nfl-mlb-epl-277a22e3","name":"Sports Game Brief API (NBA, NFL, MLB, EPL)","description":"Get normalized sports schedules, live or recent scores, matchup status, teams, venue and a concise game brief for NBA, NFL, MLB and English Premier League (EPL). Filter by league, date and optional team name or abbreviation. Use for NBA scores, NFL games, MLB scores, EPL fixtures, today's games, schedules and AI sports research.","url":"https://x402-trends-server.onrender.com/api/sports-game-brief","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":["league"],"properties":{"date":{"type":"string","description":"Game date in YYYY-MM-DD. Defaults to today's UTC date."},"team":{"type":"string","description":"Optional team name or abbreviation filter, such as LAL, Lakers, KC, Chiefs, LAD, Dodgers, Arsenal, or ARS."},"limit":{"type":"integer","maximum":20,"minimum":1,"description":"Maximum games returned. Defaults to 10 and cannot exceed 20."},"league":{"enum":["NBA","NFL","MLB","EPL"],"type":"string","description":"Sports league: NBA basketball, NFL football, MLB baseball, or EPL English Premier League soccer."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status","source","league","date","teamFilter","count","cached","stale","retrievedAt","games"],"properties":{"date":{"type":"string"},"count":{"type":"integer"},"games":{"type":"array","items":{"type":"object","required":["id","league","date","status","homeTeam","awayTeam","homeScore","awayScore","venue","summary"],"properties":{"id":{"type":["integer","string"]},"date":{"type":"string"},"clock":{"type":["string","null"]},"venue":{"type":["string","null"]},"league":{"type":"string"},"period":{"type":["integer","null"]},"status":{"type":"string"},"summary":{"type":"string"},"awayTeam":{"type":"object","required":["name","abbreviation"],"properties":{"name":{"type":"string"},"abbreviation":{"type":["string","null"]}},"additionalProperties":false},"homeTeam":{"type":"object","required":["name","abbreviation"],"properties":{"name":{"type":"string"},"abbreviation":{"type":["string","null"]}},"additionalProperties":false},"awayScore":{"type":["number","null"]},"homeScore":{"type":["number","null"]},"postseason":{"type":["boolean","null"]}},"additionalProperties":false}},"stale":{"type":"boolean"},"cached":{"type":"boolean"},"league":{"type":"string"},"source":{"type":"string"},"status":{"type":"string"},"payment":{"type":"string"},"teamFilter":{"type":["string","null"]},"retrievedAt":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_49v19AAG9Gkli_vw32Dvb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns normalized schedules, live/recent scores, matchup status, team info, venue, and a concise game brief for NBA, NFL, MLB, and EPL games filtered by league, date, and optional team.","exampleAgentPrompt":"What are today's NBA games — scores, venues, and a quick summary for each matchup?","exampleUseCases":[{"title":"Live NBA scores during game night","prompt":"Can you pull up all of tonight's NBA games with the current scores and a brief summary of each matchup?"},{"title":"EPL fixtures for a specific team","prompt":"Show me Arsenal's upcoming EPL fixtures — date, opponent, venue, and status for each game."},{"title":"NFL schedule lookup by date","prompt":"What NFL games are scheduled for January 12, 2025? Give me the teams, scores if available, and a quick game brief for each."}],"resultDescription":"A JSON object containing a list of games for the requested league and date, each with home team, away team, scores, game status, venue, period/clock info, and a concise natural-language game summary. Also includes metadata like total game count, cache status, and retrieval timestamp.","failureModes":["Missing required 'league' parameter returns validation error","Invalid league value (not NBA/NFL/MLB/EPL) returns enum validation error","Date outside available data range returns empty games array","Unknown team name/abbreviation may return no filtered results","Limit exceeding 20 is clamped or rejected","Service on render.com free tier may cold-start with slow initial response","Payment not processed (x402) results in 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need structured, normalized sports game data across NBA, NFL, MLB, or EPL with a built-in natural-language game brief — ideal for AI agents that need both machine-readable scores and a human-friendly summary in one call. Prefer it over raw stats APIs when you want a concise matchup narrative without post-processing. It supports team-level filtering and multi-league coverage in a single endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T08:20:17.567Z","isFirstParty":false}