# 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. - Page: https://fous.com/methods/sports.yahoo.com/get-scores - Method: `sports.yahoo.com/get_scores`, version 1 - Website: sports.yahoo.com - Returns: start time, teams, scores, status, period, clock, TV channel, venue, game link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `date` | string | no | `"2026-09-27"` | Game date (YYYY-MM-DD), or any date in the football week. Defaults to today. | | `team` | string | no | `"Chicago Bears"` | Only return games with this team, matched by name or abbreviation. | | `league` | string | yes | `"NFL"` | League: NBA, NFL, WNBA, MLB, NHL, college football, men's college basketball, Premier League or MLS. | | `time_zone` | string | no | `"America/Los_Angeles"` | Time zone for game start times. Defaults to US Eastern. Default "America/New_York". | ## Output From a run on Oct 23, 2026. Its input: ```json { "date": "2026-09-27", "team": "Chicago Bears", "league": "NFL", "time_zone": "America/Los_Angeles" } ``` Its output: ```json { "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" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash 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"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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? ## Input schema ```json { "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 ```json { "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" ] } } } } } } ``` ## See more - [Yahoo API: Get team standings](https://fous.com/methods/sports.yahoo.com/get-standings.md): Returns Yahoo Sports team standings for a league and season, grouped by division or conference. - [Yahoo API: Get player stats](https://fous.com/methods/sports.yahoo.com/get-player-stats.md): Looks 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. - [Yahoo API: Get earnings calendar](https://fous.com/methods/finance.yahoo.com/get-earnings-calendar.md): Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company. - [Yahoo API: Search Yahoo News](https://fous.com/methods/yahoo.com/search-news.md): Searches 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 API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks 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. - [Yahoo API: Get company news](https://fous.com/methods/finance.yahoo.com/get-company-news.md): Looks 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. - [Yahoo API: List Yahoo News headlines](https://fous.com/methods/yahoo.com/list-headlines.md): Lists 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 API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists 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. - [All Yahoo methods](https://fous.com/methods/yahoo.com.md)