Yahoo API: Get scores
Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games.
Unofficial. Not affiliated with or endorsed by Yahoo.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Date optional
date Game date (YYYY-MM-DD), or any date in the football week. Defaults to today.
2026-09-27
- Team optional
team Only return games with this team, matched by name or abbreviation.
Chicago Bears
- League, required
league League: NBA, NFL, WNBA, MLB, NHL, college football, men's college basketball, Premier League or MLS.
NFL
- Time Zone optional
time_zone Time zone for game start times. Defaults to US Eastern.
America/Los_Angeles
Default
America/New_York.
Input as JSON
{ "date": "2026-09-27", "team": "Chicago Bears", "league": "NFL", "time_zone": "America/Los_Angeles" }Output
{ "games": [ { "clock": null, "venue": "Soldier Field", "period": null, "status": "final", "game_id": "nfl.g.20260928003", "away_team": "Philadelphia Eagles", "game_link": "https://sports.yahoo.com/nfl/philadelphia-eagles-chicago-bears-20260928003/" , "home_team": "Chicago Bears", "away_score": 7, "home_score": 27, "start_time": "2026-09-28T17:15:00-07:00", "tv_channel": "ABC/ESPN" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"sports.yahoo.com/get_scores","input":{"date":"2026-09-27","team":"Chicago Bears","league":"NFL","time_zone":"America/Los_Angeles"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "sports.yahoo.com/get_scores" , "input": { "date": "2026-09-27", "team": "Chicago Bears", "league": "NFL", "time_zone": "America/Los_Angeles" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "sports.yahoo.com/get_scores" , "input": { "date": "2026-09-27", "team": "Chicago Bears", "league": "NFL", "time_zone": "America/Los_Angeles" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run sports.yahoo.com/get_scores# with {"date":"2026-09-27","team":"Chicago Bears","league":"NFL","time_zone":"America/Los_Angeles"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "league" ], "properties": { "date": { "type": "string", "examples": [ "2026-09-29" ], "description": "Game date (YYYY-MM-DD), or any date in the football week. Defaults to today." }, "team": { "type": "string", "examples": [ "Indiana Fever" ], "description": "Only return games with this team, matched by name or abbreviation." }, "league": { "type": "string", "examples": [ "NBA" ], "description": "League: NBA, NFL, WNBA, MLB, NHL, college football, men's college basketball, Premier League or MLS." }, "time_zone": { "type": "string", "default": "America/New_York" , "examples": [ "America/Los_Angeles" ], "description": "Time zone for game start times. Defaults to US Eastern." } }}Output schema
{ "type": "object", "required": [ "games" ], "properties": { "games": { "type": "array", "items": { "type": "object", "required": [ "start_time", "away_team", "home_team", "status", "game_link", "game_id" ], "properties": { "clock": { "type": [ "string", "null" ] }, "venue": { "type": [ "string", "null" ] }, "period": { "type": [ "string", "null" ] }, "status": { "enum": [ "scheduled", "live", "final" ], "type": "string" }, "game_id": { "type": "string" }, "away_team": { "type": "string" }, "game_link": { "type": "string" }, "home_team": { "type": "string" }, "away_score": { "type": [ "integer", "null" ] }, "home_score": { "type": [ "integer", "null" ] }, "start_time": { "type": "string" }, "tv_channel": { "type": [ "string", "null" ] } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
sports.yahoo.com/get_scores- Returns
- start time, teams, scores, status, period, clock, TV channel, venue, game link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method sports.yahoo.com/get_scores with the inputs above.
Ask your agent
- What time do the Lakers play tonight and what channel is it on?
- Show me all NFL games this Sunday with final scores
- Did the Indiana Fever win their game on September 20th?
- Give me the MLB scores from yesterday, Pacific time, with venue names
- Any Premier League matches this weekend and their current status on Yahoo Sports?
See more
All Yahoo methodsReturns Yahoo Sports team standings for a league and season, grouped by division or conference.
sports.yahoo.com/get_standingsLooks up a Yahoo Sports player by name and returns the player's regular-season statistics for a season, alongside career totals. Each stat includes season and career values.
sports.yahoo.com/get_player_statsGets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company.
finance.yahoo.com/get_earnings_calendarSearches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section.
yahoo.com/search_newsLooks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed.
finance.yahoo.com/get_quoteLooks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one.
finance.yahoo.com/get_company_newsLists the latest Yahoo News headlines for a section in page order, with summary, byline, original publisher, image and publication time when the article provides them.
yahoo.com/list_headlinesLists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap.
finance.yahoo.com/list_market_movers