# Yahoo API: Get team standings > Returns Yahoo Sports team standings for a league and season, grouped by division or conference. Unofficial. Not affiliated with or endorsed by Yahoo. - Page: https://fous.com/methods/sports.yahoo.com/get-standings - Method: `sports.yahoo.com/get_standings`, version 1 - Website: sports.yahoo.com - Returns: group, rank, team, wins, losses, ties, overtime losses, win percentage, games behind, points, streak, last 10 games, team page URL - 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 | |---|---|---|---|---| | `league` | string | yes | `"NFL"` | League name, for example NBA or Premier League. | | `season` | integer | no | | Starting year of the season, for example 2025. Defaults to the season selected by Yahoo Sports. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "league": "NFL" } ``` Its output: ```json { "teams": [ { "rank": 1, "team": "Buffalo", "ties": 0, "wins": 5, "group": "AFC East", "losses": 1, "points": null, "page_url": "https://sports.yahoo.com/nfl/teams/buffalo/", "games_behind": null, "last_10_games": null, "current_streak": "W-2", "win_percentage": 0.833, "overtime_losses": null }, { "rank": 2, "team": "New England", "ties": 0, "wins": 4, "group": "AFC East", "losses": 3, "points": null, "page_url": "https://sports.yahoo.com/nfl/teams/new-england/", "games_behind": null, "last_10_games": null, "current_streak": "L-1", "win_percentage": 0.571, "overtime_losses": null }, { "rank": 3, "team": "NY Jets", "ties": 0, "wins": 2, "group": "AFC East", "losses": 4, "points": null, "page_url": "https://sports.yahoo.com/nfl/teams/ny-jets/", "games_behind": null, "last_10_games": null, "current_streak": "L-1", "win_percentage": 0.333, "overtime_losses": null } ], "league": "NFL", "season": 2026 } ``` ## 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_standings","input":{"league":"NFL"}}' ``` 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 are the current NBA standings grouped by conference for the 2025 season? - Show me the Premier League table for 2024 with points and goal records if available. - I need the NHL division standings for the 2023 season, including overtime losses and streaks. - Can you pull up Yahoo Sports standings for the MLB 2025 season by division with games behind? - Which teams are on top of the Eastern Conference right now in the NBA, and what are their last 10 records? ## Input schema ```json { "type": "object", "required": [ "league" ], "properties": { "league": { "type": "string", "description": "League name, for example NBA or Premier League." }, "season": { "type": "integer", "description": "Starting year of the season, for example 2025. Defaults to the season selected by Yahoo Sports." } } } ``` ## Output schema ```json { "type": "object", "required": [ "league", "season", "teams" ], "properties": { "teams": { "type": "array", "items": { "type": "object", "required": [ "group", "rank", "team", "wins", "losses", "ties", "overtime_losses", "win_percentage", "games_behind", "points", "current_streak", "last_10_games", "page_url" ], "properties": { "rank": { "type": "integer" }, "team": { "type": "string" }, "ties": { "type": [ "integer", "null" ] }, "wins": { "type": [ "integer", "null" ] }, "group": { "type": "string", "description": "Division, conference, or league group." }, "losses": { "type": [ "integer", "null" ] }, "points": { "type": [ "integer", "null" ] }, "page_url": { "type": "string", "format": "uri" }, "games_behind": { "type": [ "number", "null" ] }, "last_10_games": { "type": [ "string", "null" ] }, "current_streak": { "type": [ "string", "null" ] }, "win_percentage": { "type": [ "number", "null" ], "description": "Wins divided by games played where Yahoo does not publish a percentage." }, "overtime_losses": { "type": [ "integer", "null" ] } }, "additionalProperties": false } }, "league": { "type": "string" }, "season": { "type": "integer" } }, "additionalProperties": false } ``` ## See more - [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): 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. - [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: 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. - [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: 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 price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency. - [All Yahoo methods](https://fous.com/methods/yahoo.com.md)