nhl-api

A Rust client library for the NHL API. Get teams, scores, schedules, standings, and game stats.

Based on the excellent nhl-api-py.

Installation

Add to your Cargo.toml:

[dependencies]
nhl_api = "0.5"
tokio = { version = "1", features = ["full"] }

Usage

use nhl_api::{Client, GameDate};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    // Get current standings
    let standings = client.league_standings_for_date(GameDate::Now).await?;
    for standing in standings.standings {
        println!("{}: {} pts", standing.team_name.default, standing.points);
    }

    // Get today's schedule
    let schedule = client.daily_schedule(GameDate::Now).await?;
    for game_day in schedule.game_week {
        println!("{}", game_day.date);
        for game in game_day.games {
            println!("  {} @ {}",
                game.away_team.abbrev,
                game.home_team.abbrev
            );
        }
    }

    // Get boxscore for a specific game
    let boxscore = client.boxscore(2023020001).await?;
    println!("{} {} - {} {}",
        boxscore.away_team.abbrev, boxscore.away_team.score,
        boxscore.home_team.abbrev, boxscore.home_team.score
    );

    Ok(())
}

Examples

Get standings for a specific date:

use chrono::NaiveDate;
use nhl_api::{Client, GameDate};

let date = NaiveDate::from_ymd_opt(2024, 1, 15).unwrap();
let standings = client.league_standings_for_date(GameDate::Date(date)).await?;

Get a week's schedule:

let schedule = client.weekly_schedule(GameDate::Now).await?;

License

GPL-3.0-or-later