Skip to contents

The NCAA has a lot of sports stats available at https://stats.ncaa.org. This package focuses on volleyball, though some of the functions can be used for other sports (e.g., get_teams()). The sport code for selecting women’s volleyball is “WVB” and men’s is “MVB”. Once you pick one of those, you can access season, match, and play-by-play stats for players and teams.

Finding teams

The NCAA uses a unique team ID for each women's and men's volleyball team and each season. So first you will need to get that ID with the find_team_id(). I'll use Nebraska to illustrate the functions in {ncaavolleyballr}.

However, before we find the team ID, we first have to know the exact team name that the NCAA uses to reference each team. Is Nebraska’s team name Nebraska, Neb., University of Nebraska-Lincoln, UNL, or something else? We can use find_team_name() to get a vector of teams that match a pattern.

find_team_name("Neb")
#> [1] "Neb. Wesleyan" "Neb.-Kearney"  "Nebraska"

Looks like it’s “Nebraska”. So now we can pass that to find_team_id() along with the year that we’re interested in. This function queries two data sets that ship with this package: wvb_teams and mvb_teams. These two data sets are simply the output of the get_teams() function being applied to sports “WVB” and “MVB” respectively. The get_teams() function can be applied to other sports to get the list of all of their team IDs. But since we’ve already done that for men’s and women’s volleyball, you won’t need to use get_teams().

OK, let’s find Nebraska’s team ID for 2024.

find_team_id("Nebraska", 2024)
#> [1] "585290"

We’ll need this team ID to access all of the team’s statistics. You can either assign the output to an object or just add it to the top of your pipeline.

You can also pass vectors of team names and years to find team IDs for multiple teams and years.

find_team_id("Nebraska", 2020:2024)
#> [1] "504517" "523117" "538902" "558878" "585290"
find_team_id(c("Nebraska", "Wisconsin"), 2024)
#> [1] "585290" "585357"
find_team_id(c("Nebraska", "Wisconsin"), 2020:2024)
#>  [1] "504517" "504318" "523117" "522809" "538902" "538704" "558878" "559025"
#>  [9] "585290" "585357"

Note these are processed per year, so the last example are the teams ID’s for Nebraska and Wisconsin in 2020 then 2021, etc.

Season stats

Now that we have the team ID, we can use it to access season summary statistics for a particular team and year (e.g., Nebraska 2024).

Team season information

Before we get to stats, we can extract information about a team’s season with team_season_info(), The NCAA’s main page for a team and year includes a tab called “Schedule/Results”. The team_season_stats() function extracts information about the team’s venue, coach, and records, as well as the table of the schedule and results.

(neb2024team <- find_team_id("Nebraska", 2024) |>
   team_season_info())
#> $team_info
#>      team_id team_name conference_id conference div   yr    season
#> 1466  585290  Nebraska           827    Big Ten   1 2024 2024-2025
#> 
#> $arena
#>                  Arena name                    Capacity 
#> "Bob Devaney Sports Center"                     "7,907" 
#>                  Year built 
#>                      "1975" 
#> 
#> $coach
#>               Name         Alma mater            Seasons             Record 
#>        "John Cook" "San Diego - 1979"               "32"          "883-176" 
#> 
#> $record
#>      Overall record      Overall streak   Conference record   Conference streak 
#>      "33-3 (0.917)"        "Streak: L1"      "19-1 (0.950)"        "Streak: L1" 
#>         Home record         Home streak         Road record         Road streak 
#>      "22-0 (1.000)"       "Streak: W45"      "10-2 (0.833)"        "Streak: W1" 
#>      Neutral record      Neutral streak Non-division record Non-division streak 
#>       "1-1 (0.500)"        "Streak: L1"       "0-0 (0.000)"         "Streak: 0" 
#> 
#> $schedule
#> # A tibble: 36 × 4
#>    Date       Opponent                 Result Attendance
#>    <chr>      <chr>                    <chr>  <chr>     
#>  1 08/27/2024 Kentucky @Louisville, KY W 3-1  9,280     
#>  2 08/30/2024 A&M-Corpus Christi       W 3-0  8,956     
#>  3 08/31/2024 TCU                      W 3-1  8,695     
#>  4 09/03/2024 @ SMU                    L 0-3  6,773     
#>  5 09/05/2024 The Citadel              W 3-0  8,607     
#>  6 09/07/2024 Montana St.              W 3-0  8,456     
#>  7 09/10/2024 Creighton                W 3-2  8,924     
#>  8 09/13/2024 Arizona St.              W 3-0  8,772     
#>  9 09/14/2024 Wichita St.              W 3-0  8,541     
#> 10 09/18/2024 Stanford                 W 3-0  8,952     
#> # ℹ 26 more rows

This returns a list, so you can subset specific components with $. For instance, if we wanted to calculate average attendance per game:

neb2024team$schedule |>
  dplyr::pull(Attendance) |>
  sub(",", "", x = _) |>
  as.numeric() |>
  mean()
#> [1] 8765.333

Wow, Nebraska volleyball attracted more attendees per game than the 2021 Oakland Athletics professional baseball team!

Team season stats

The NCAA makes team season summary stats available since. We have included the conference starting with 2020 (conference data for previous seasons is not currently available).

team_season_stats(team = "Nebraska")
Year Team Conference S Kills Errors Total Attacks Hit Pct Assists Aces SErr Digs RetAtt RErr Block Solos Block Assists BErr PTS BHE Trpl Dbl
2001-02 Nebraska NA 108 1790 532 4130 0.305 1575 162 NA 1833 NA NA 116 670 NA NA NA 1
2002-03 Nebraska NA 103 1747 481 3927 0.322 1532 169 NA 1642 NA NA 81 626 NA NA NA 1
2003-04 Nebraska NA 117 1915 720 4806 0.249 1748 225 NA 1941 NA NA 80 582 NA NA NA 1
2004-05 Nebraska NA 106 1823 610 4322 0.281 1657 166 NA 1846 NA NA 89 675 NA NA NA 1
2005-06 Nebraska NA 116 1986 581 4367 0.322 1823 162 NA 1731 NA NA 66 823 NA NA NA 1
2006-07 Nebraska NA 115 2001 637 4605 0.296 1863 175 NA 1942 NA NA 94 531 NA NA NA 1
2007-08 Nebraska NA 103 1829 506 4051 0.327 1691 187 NA 1687 NA NA 90 397 NA NA NA 1
2008-09 Nebraska NA 118 1714 590 4166 0.270 1578 154 NA 1734 NA NA 78 451 NA NA NA 1
2009-10 Nebraska NA 115 1685 618 4160 0.256 1568 130 NA 1837 NA NA 75 398 NA NA NA 1
2010-11 Nebraska NA 108 1609 528 3812 0.284 1501 127 148 1698 NA 77 73 510 79 2064.0 11 NA
2011-12 Nebraska NA 113 1532 504 3866 0.266 1426 91 161 1696 NA 95 52 484 77 1917.0 18 NA
2012-13 Nebraska NA 123 1728 509 4171 0.292 1617 139 217 1767 NA 94 79 477 68 2184.5 15 NA
2013-14 Nebraska NA 119 1710 593 4132 0.270 1597 115 241 1714 NA 82 69 538 96 2163.0 20 NA
2014-15 Nebraska NA 118 1564 599 4089 0.236 1476 118 220 1699 NA 93 72 543 64 2025.5 23 NA
2015-16 Nebraska NA 129 1873 589 4690 0.274 1730 140 232 2049 NA 79 55 605 67 2370.5 24 NA
2016-17 Nebraska NA 117 1688 533 4026 0.287 1558 142 215 1785 NA 69 57 546 59 2160.0 19 NA
2017-18 Nebraska NA 125 1777 575 4267 0.282 1632 184 236 1904 NA 80 61 479 68 2261.5 22 NA
2018-19 Nebraska NA 133 1772 582 4491 0.265 1651 215 285 2100 NA 124 56 601 99 2343.5 14 NA
2019-20 Nebraska NA 119 1641 567 4029 0.267 1526 125 238 1802 2087 126 50 470 66 1940.0 11 10
2020-21 Nebraska NA 66 925 323 2229 0.270 847 104 131 957 1155 71 21 269 40 1184.5 12 19
2021-22 Nebraska NA 121 1677 667 4551 0.222 1548 181 241 2054 2164 105 38 530 54 2161.0 8 34
2022-23 Nebraska NA 109 1461 519 3866 0.244 1331 128 261 1721 1824 77 33 537 47 1890.5 25 32
2023-24 Nebraska NA 121 1676 597 3959 0.273 1553 143 309 1666 2018 104 39 574 43 2145.0 15 35
2024-25 Nebraska NA 122 1721 551 4114 0.284 1596 155 193 1856 1920 81 51 581 50 2217.5 1 36

By default, the teams’s stats are returned. To return the opposing teams stats, set opponents = TRUE.

team_season_stats(team = "Nebraska", opponent = TRUE)
Year Team Conference S Kills Errors Total Attacks Hit Pct Assists Aces SErr Digs RetAtt RErr Block Solos Block Assists BErr PTS BHE Trpl Dbl
2010-11 Opponent NA 108 1235 679 3833 0.145 1174 77 174 1480 NA 127 33 322 59 1506.0 23 NA
2011-12 Opponent NA 113 1305 724 3998 0.145 1234 95 195 1599 NA 91 28 294 59 1575.0 29 NA
2012-13 Opponent NA 123 1543 697 4316 0.196 1452 94 209 1688 NA 139 50 362 69 1868.0 35 NA
2013-14 Opponent NA 119 1438 684 4119 0.183 1371 82 226 1592 NA 115 46 398 70 1765.0 22 NA
2014-15 Opponent NA 118 1507 746 4246 0.179 1405 93 226 1645 NA 118 40 417 74 1848.5 39 NA
2015-16 Opponent NA 129 1577 760 4756 0.172 1494 79 237 1916 NA 140 53 387 89 1902.5 40 NA
2016-17 Opponent NA 117 1309 708 4102 4.587 1243 69 236 1573 NA 142 40 355 59 1595.5 22 NA
2017-18 Opponent NA 125 1368 701 4335 0.154 1276 80 278 1634 NA 184 60 357 66 1686.5 25 NA
2018-19 Opponent NA 133 1460 780 4719 0.144 1376 124 296 1905 NA 215 39 388 59 1817.0 41 NA
2019-20 Opponent NA 119 1344 703 4205 0.152 1243 126 252 1581 2532 125 45 341 66 1595.5 34 10
2020-21 Opponent NA 66 739 365 2226 0.168 679 71 160 831 1424 104 16 236 26 944.0 6 19
2021-22 Opponent NA 121 1349 693 4418 0.148 1269 105 267 1886 2595 181 49 503 52 1754.5 16 34
2022-23 Opponent NA 109 1198 689 3988 0.128 1114 77 297 1575 2337 128 29 370 51 1489.0 24 32
2023-24 Opponent NA 121 1264 713 4009 0.137 1188 104 325 1402 2552 143 42 430 58 1625.0 17 35
2024-25 Opponent NA 122 1376 749 4377 0.143 1321 81 342 1539 2748 155 34 375 49 1678.5 1 36

Here’s a table describing the different team statistics returned.

data.frame(Stat = colnames(team_season_stats(team = "Nebraska"))[4:20],
           Description = c("Sets played", "Kills", "Attack errors", "Attacks", 
                           "Hit percentage [(kills-errors)/attacks]", "Assists",
                           "Ace serves", "Service errors", "Digs", 
                           "Reception attempts", "Reception errors", 
                           "Solo blocks", "Block assists", "Block errors", 
                           "Points", "Ball handling errors", "Triple doubles"))
Stat Description
S Sets played
Kills Kills
Errors Attack errors
Total Attacks Attacks
Hit Pct Hit percentage [(kills-errors)/attacks]
Assists Assists
Aces Ace serves
SErr Service errors
Digs Digs
RetAtt Reception attempts
RErr Reception errors
Block Solos Solo blocks
Block Assists Block assists
BErr Block errors
PTS Points
BHE Ball handling errors
Trpl Dbl Triple doubles

Player season stats

The NCAA’s main page for a team includes a tab called “Team Statistics” (e.g., Nebraska 2024). The player_season_stats() function extracts the table of player summary statistics for a particular season, as well as team and opponent statistics (though these can be omitted).

find_team_id("Nebraska", 2024) |>
  player_season_stats()
Season Team Conference Number Player Yr Pos Ht Hometown High School GP GS S Kills Errors Total Attacks Hit Pct Assists Aces SErr Digs RetAtt RErr Block Solos Block Assists BErr PTS BHE Trpl Dbl
2024-2025 Nebraska Big Ten 2 Bergen Reilly So S 6-1 Sioux Falls, SD O’Gorman 36 36 122 81 14 175 0.383 1352 21 37 348 4 NA 3 59 8 134.5 NA NA
2024-2025 Nebraska Big Ten 5 Rebekah Allick Jr MB 6-4 Lincoln, NE Waverly 35 34 109 198 57 395 0.357 9 NA NA 34 5 1 19 137 13 285.5 NA NA
2024-2025 Nebraska Big Ten 6 Laney Choboy So L/DS 5-3 Raleigh, NC Leesville Road 36 0 121 0 0 3 0.000 36 NA 1 185 311 10 NA NA NA NA NA NA
2024-2025 Nebraska Big Ten 7 Maisie Boesiger Jr L/DS 5-6 Firth, NE Norris 9 0 13 0 0 0 NA NA NA NA 6 1 NA NA NA NA NA NA NA
2024-2025 Nebraska Big Ten 8 Lexi Rodriguez Sr L/DS 5-5 Sterling, IL Sterling 36 0 122 0 0 8 0.000 127 17 23 473 431 16 NA NA NA 17.0 NA NA
2024-2025 Nebraska Big Ten 9 Kennedi Orr Sr S 6-0 Eagan, MN Eagan 35 0 112 0 0 1 0.000 2 10 23 63 NA NA NA NA NA 10.0 NA NA
2024-2025 Nebraska Big Ten 10 Olivia Mauch Fr L/DS 5-6 Bennington, NE Bennington 36 4 122 0 0 0 NA 13 21 18 196 412 17 NA NA NA 21.0 NA NA
2024-2025 Nebraska Big Ten 11 Leyla Blackwell Sr MB 6-4 San Diego, CA La Jolla 13 4 23 54 11 103 0.417 4 NA NA 4 5 NA 2 27 1 69.5 NA NA
2024-2025 Nebraska Big Ten 12 Taylor Landfair Sr OH 6-5 Plainfield, IL Plainfield Central 33 20 88 219 90 600 0.215 3 1 3 44 73 3 1 49 3 245.5 1 NA
2024-2025 Nebraska Big Ten 13 Merritt Beason Sr OH 6-4 Gardendale, AL Gardendale 36 36 122 339 133 883 0.233 16 30 37 150 17 1 6 104 8 427.0 NA NA
2024-2025 Nebraska Big Ten 15 Andi Jackson So MB 6-3 Brighton, CO Brighton 34 34 114 299 73 515 0.439 2 1 5 26 2 NA 12 122 4 373.0 NA NA
2024-2025 Nebraska Big Ten 22 Lindsay Krause Sr OH 6-4 Papillion, NE Skutt Catholic 24 12 50 120 43 336 0.229 2 15 12 33 54 3 3 23 3 149.5 NA NA
2024-2025 Nebraska Big Ten 27 Harper Murray So OH 6-2 Ann Arbor, MI Skyline 36 36 121 411 130 1095 0.257 30 39 34 294 598 23 5 60 10 485.0 NA NA
2024-2025 Nebraska Big Ten NA TEAM - - - NA NA NA NA NA NA NA NA NA NA NA NA NA NA 7 NA NA NA NA NA NA
2024-2025 Nebraska Big Ten NA Totals - - - NA NA NA NA 122 1721 551 4114 0.284 1596 155 193 1856 1920 81 51 581 50 2217.5 1 36
2024-2025 Nebraska Big Ten NA Opponent Totals - - - NA NA NA NA 122 1376 749 4377 0.143 1321 81 342 1539 2748 155 34 375 49 1678.5 1 36

This returns all players, along with TEAM, opponent, and overall team summaries. To only include player stats, set team_stats = FALSE.

find_team_id("Nebraska", 2024) |>
  player_season_stats(team_stats = FALSE)
Season Team Conference Number Player Yr Pos Ht Hometown High School GP GS S Kills Errors Total Attacks Hit Pct Assists Aces SErr Digs RetAtt RErr Block Solos Block Assists BErr PTS BHE Trpl Dbl
2024-2025 Nebraska Big Ten 2 Bergen Reilly So S 6-1 Sioux Falls, SD O’Gorman 36 36 122 81 14 175 0.383 1352 21 37 348 4 NA 3 59 8 134.5 NA NA
2024-2025 Nebraska Big Ten 5 Rebekah Allick Jr MB 6-4 Lincoln, NE Waverly 35 34 109 198 57 395 0.357 9 NA NA 34 5 1 19 137 13 285.5 NA NA
2024-2025 Nebraska Big Ten 6 Laney Choboy So L/DS 5-3 Raleigh, NC Leesville Road 36 0 121 0 0 3 0.000 36 NA 1 185 311 10 NA NA NA NA NA NA
2024-2025 Nebraska Big Ten 7 Maisie Boesiger Jr L/DS 5-6 Firth, NE Norris 9 0 13 0 0 0 NA NA NA NA 6 1 NA NA NA NA NA NA NA
2024-2025 Nebraska Big Ten 8 Lexi Rodriguez Sr L/DS 5-5 Sterling, IL Sterling 36 0 122 0 0 8 0.000 127 17 23 473 431 16 NA NA NA 17.0 NA NA
2024-2025 Nebraska Big Ten 9 Kennedi Orr Sr S 6-0 Eagan, MN Eagan 35 0 112 0 0 1 0.000 2 10 23 63 NA NA NA NA NA 10.0 NA NA
2024-2025 Nebraska Big Ten 10 Olivia Mauch Fr L/DS 5-6 Bennington, NE Bennington 36 4 122 0 0 0 NA 13 21 18 196 412 17 NA NA NA 21.0 NA NA
2024-2025 Nebraska Big Ten 11 Leyla Blackwell Sr MB 6-4 San Diego, CA La Jolla 13 4 23 54 11 103 0.417 4 NA NA 4 5 NA 2 27 1 69.5 NA NA
2024-2025 Nebraska Big Ten 12 Taylor Landfair Sr OH 6-5 Plainfield, IL Plainfield Central 33 20 88 219 90 600 0.215 3 1 3 44 73 3 1 49 3 245.5 1 NA
2024-2025 Nebraska Big Ten 13 Merritt Beason Sr OH 6-4 Gardendale, AL Gardendale 36 36 122 339 133 883 0.233 16 30 37 150 17 1 6 104 8 427.0 NA NA
2024-2025 Nebraska Big Ten 15 Andi Jackson So MB 6-3 Brighton, CO Brighton 34 34 114 299 73 515 0.439 2 1 5 26 2 NA 12 122 4 373.0 NA NA
2024-2025 Nebraska Big Ten 22 Lindsay Krause Sr OH 6-4 Papillion, NE Skutt Catholic 24 12 50 120 43 336 0.229 2 15 12 33 54 3 3 23 3 149.5 NA NA
2024-2025 Nebraska Big Ten 27 Harper Murray So OH 6-2 Ann Arbor, MI Skyline 36 36 121 411 130 1095 0.257 30 39 34 294 598 23 5 60 10 485.0 NA NA

This returns all of the stats included by team_season_stats(), plus GP and GS, which are Games Played and Games Started, respectively.

Match stats

In addition to overall season summary stats, the NCAA provides match-level data for both teams and individual players.

Team match stats

To get overall match stats for a team in a particular season, use team_match_stats().

find_team_id(team = "Nebraska", year = 2024) |>
  team_match_stats()
Date Team Conference Opponent Result S Kills Errors Total Attacks Hit Pct Assists Aces SErr Digs RetAtt RErr Block Solos Block Assists BErr PTS BHE
08/27/2024 Nebraska Big Ten Kentucky @Louisville, KY W 3-1 4 47 16 120 0.258 44 4 8 51 66 6 3 30 1 69.0 NA
08/30/2024 Nebraska Big Ten A&M-Corpus Christi W 3-0 3 48 7 96 0.427 43 7 5 48 36 2 1 13 5 62.5 NA
08/31/2024 Nebraska Big Ten TCU W 3-1 4 55 25 141 0.213 52 9 11 61 64 NA 4 16 NA 76.0 NA
09/03/2024 Nebraska Big Ten @ SMU L 0-3 3 36 18 105 0.171 35 1 11 36 64 7 NA 18 3 46.0 NA
09/05/2024 Nebraska Big Ten The Citadel W 3-0 3 43 7 98 0.367 39 6 11 42 37 NA 2 13 3 57.5 NA
09/07/2024 Nebraska Big Ten Montana St. W 3-0 3 47 11 90 0.400 44 7 5 39 40 2 NA 8 3 58.0 NA
09/10/2024 Nebraska Big Ten Creighton W 3-2 5 73 27 193 0.238 67 2 9 81 88 4 NA 23 3 86.5 NA
09/13/2024 Nebraska Big Ten Arizona St. W 3-0 3 48 12 113 0.319 47 2 11 55 52 NA NA 14 2 57.0 NA
09/14/2024 Nebraska Big Ten Wichita St. W 3-0 3 50 8 88 0.477 44 3 1 47 33 1 1 12 1 60.0 NA
09/18/2024 Nebraska Big Ten Stanford W 3-0 3 38 13 95 0.263 36 5 4 38 45 2 1 16 NA 52.0 NA
09/22/2024 Nebraska Big Ten @ Louisville W 3-0 3 36 7 95 0.305 33 7 7 38 48 NA 2 14 1 52.0 NA
09/27/2024 Nebraska Big Ten UCLA W 3-1 4 54 19 142 0.246 51 2 8 62 64 1 3 20 3 69.0 NA
09/29/2024 Nebraska Big Ten Southern California W 3-0 3 41 16 102 0.245 39 4 8 47 45 1 2 6 NA 50.0 NA
10/03/2024 Nebraska Big Ten @ Illinois W 3-0 3 41 9 103 0.311 33 5 1 46 48 2 1 22 1 58.0 NA
10/06/2024 Nebraska Big Ten Iowa W 3-0 3 44 8 89 0.404 41 7 1 36 37 NA 3 6 2 57.0 NA
10/11/2024 Nebraska Big Ten Purdue W 3-2 5 NA 31 178 0.242 68 3 7 69 91 1 NA 11 1 82.5 NA
10/12/2024 Nebraska Big Ten Rutgers W 3-0 3 43 11 102 0.314 41 3 2 51 35 2 1 16 1 55.0 NA
10/18/2024 Nebraska Big Ten @ Michigan St. W 3-0 3 48 12 99 0.364 43 2 5 46 43 1 1 10 1 56.0 NA
10/19/2024 Nebraska Big Ten @ Ohio St. W 3-0 3 48 10 103 0.369 45 3 1 58 48 3 2 14 1 60.0 NA
10/25/2024 Nebraska Big Ten Illinois W 3-0 3 49 12 109 0.339 48 5 5 49 57 3 NA 14 NA 61.0 NA
10/26/2024 Nebraska Big Ten Michigan W 3-1 4 55 27 136 0.206 49 6 4 54 64 NA 1 18 1 71.0 NA
11/01/2024 Nebraska Big Ten @ Wisconsin W 3-0 3 40 19 104 0.202 35 5 6 43 58 2 1 19 NA 55.5 NA
11/03/2024 Nebraska Big Ten @ Northwestern W 3-0 3 39 12 94 0.287 34 7 5 40 44 2 1 12 1 53.0 NA
11/07/2024 Nebraska Big Ten @ Oregon W 3-0 3 44 14 108 0.278 40 4 NA 52 50 3 2 8 NA 54.0 NA
11/09/2024 Nebraska Big Ten @ Washington W 3-0 3 44 11 88 0.375 39 5 2 38 43 1 1 12 1 56.0 NA
11/14/2024 Nebraska Big Ten Minnesota W 3-1 4 54 21 166 0.199 54 2 5 82 67 1 2 20 1 68.0 NA
11/16/2024 Nebraska Big Ten Indiana W 3-0 3 45 11 105 0.324 41 1 5 49 45 3 NA 12 1 52.0 NA
11/20/2024 Nebraska Big Ten @ Iowa W 3-0 3 50 8 89 0.472 48 4 4 46 40 5 1 18 NA 64.0 NA
11/23/2024 Nebraska Big Ten Wisconsin W 3-0 3 47 19 108 0.259 41 1 4 54 51 3 2 10 NA 55.0 NA
11/29/2024 Nebraska Big Ten @ Penn St. L 1-3 4 46 24 143 0.154 44 1 4 60 76 3 3 26 1 63.0 NA
11/30/2024 Nebraska Big Ten @ Maryland W 3-1 4 50 20 116 0.259 49 7 9 50 53 4 5 30 3 77.0 NA
12/06/2024 Nebraska Big Ten Florida A&M 2024 NCAA Division I Women’s Volleyball Championship W 3-0 3 43 9 87 0.391 43 6 3 45 27 1 NA 12 NA 55.0 NA
12/07/2024 Nebraska Big Ten #8 Miami (FL) 2024 NCAA Division I Women’s Volleyball Championship W 3-0 3 41 14 92 0.293 38 3 4 43 47 1 NA 20 1 54.0 NA
12/13/2024 Nebraska Big Ten #5 Dayton 2024 NCAA Division I Women’s Volleyball Championship W 3-1 4 53 24 134 0.216 50 7 7 69 63 4 NA 23 4 71.5 NA
12/15/2024 Nebraska Big Ten #2 Wisconsin 2024 NCAA Division I Women’s Volleyball Championship W 3-0 3 42 17 119 0.210 36 3 3 59 56 3 3 19 1 57.5 NA
12/19/2024 Nebraska Big Ten #1 Penn St. @Louisville, KY (2024 NCAA Division I Women’s Volleyball Championship) L 2-3 5 65 22 164 0.262 62 6 7 72 95 7 2 26 3 86.0 1
Totals Nebraska Big Ten Totals Totals 122 1721 551 4114 0.284 1596 155 193 1856 1920 81 51 581 50 2217.5 1

Player match stats

Similarly, you can get match stats for each player in a single match. But to do this, you must know the NCAA’s contest ID for the particular match or matches that you’re interested in. Use the find_team_contests() function to return a data frame of all of the matches for a particular team and season, along with the contest IDs.

(neb2024contests <- find_team_id(team = "Nebraska", year = 2024) |>
  find_team_contests())
date team opponent result attendance contest
08/27/2024 Nebraska Kentucky W 3-1 9280 5362360
08/30/2024 Nebraska A&M-Corpus Christi W 3-0 8956 5362361
08/31/2024 Nebraska TCU W 3-1 8695 5362362
09/03/2024 Nebraska SMU L 0-3 6773 5362363
09/05/2024 Nebraska The Citadel W 3-0 8607 5362364
09/07/2024 Nebraska Montana St. W 3-0 8456 5362365
09/10/2024 Nebraska Creighton W 3-2 8924 5362366
09/13/2024 Nebraska Arizona St. W 3-0 8772 5362367
09/14/2024 Nebraska Wichita St. W 3-0 8541 5362368
09/18/2024 Nebraska Stanford W 3-0 8952 5362369
09/22/2024 Nebraska Louisville W 3-0 14126 5362370
09/27/2024 Nebraska UCLA W 3-1 8846 5375032
09/29/2024 Nebraska Southern California W 3-0 8689 5375033
10/03/2024 Nebraska Illinois W 3-0 4352 5362119
10/06/2024 Nebraska Iowa W 3-0 8667 5365053
10/11/2024 Nebraska Purdue W 3-2 8715 5375022
10/12/2024 Nebraska Rutgers W 3-0 8500 5375034
10/18/2024 Nebraska Michigan St. W 3-0 8291 5375035
10/19/2024 Nebraska Ohio St. W 3-0 4156 5362668
10/25/2024 Nebraska Illinois W 3-0 8551 5362123
10/26/2024 Nebraska Michigan W 3-1 8517 5375003
11/01/2024 Nebraska Wisconsin W 3-0 7229 5375037
11/03/2024 Nebraska Northwestern W 3-0 6003 5697061
11/07/2024 Nebraska Oregon W 3-0 8566 5375039
11/09/2024 Nebraska Washington W 3-0 9768 5375040
11/14/2024 Nebraska Minnesota W 3-1 8703 5362077
11/16/2024 Nebraska Indiana W 3-0 8727 5361321
11/20/2024 Nebraska Iowa W 3-0 3933 5365061
11/23/2024 Nebraska Wisconsin W 3-0 9009 5375041
11/29/2024 Nebraska Penn St. L 1-3 6597 5375042
11/30/2024 Nebraska Maryland W 3-1 13071 5375043
12/06/2024 Nebraska Florida A&M W 3-0 8702 6080756
12/07/2024 Nebraska Miami (FL) W 3-0 8684 6080754
12/13/2024 Nebraska Dayton W 3-1 8725 6081051
12/15/2024 Nebraska Wisconsin W 3-0 8743 6081043
12/19/2024 Nebraska Penn St. L 2-3 21726 6080708

Once we have the contest IDs, we can grab one and pass it to player_match_stats().

player_match_stats(contest = "6080708")
Season Date Team Conference Opponent Team Opponent Conference Location Number Player P S Kills Errors TotalAttacks HitPct Assists Aces SErr Digs RetAtt RErr BlockSolos BlockAssists BErr PTS BHE
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 2 Ava Falduto L/DS 5 0 0 0 0.000 1 2 1 3 7 0 0 0 0 2.0 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 3 Gillian Grimes L/DS 5 0 0 0 0.000 9 1 3 25 39 1 0 0 0 1.0 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 8 Camryn Hannah OH 5 16 7 44 0.205 0 1 2 5 6 0 1 0 0 18.0 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 5 Jordan Hopp MB 4 1 1 4 0.000 0 0 0 0 0 0 1 3 0 3.5 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 14 Caroline Jurevicius OH 5 20 8 42 0.286 0 0 0 2 0 0 0 4 0 22.0 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 44 Maggie Mendelson MB 2 1 1 4 0.000 1 0 0 1 0 0 0 0 0 1.0 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 24 Quinn Menger DS 5 0 0 0 0.000 0 1 2 0 0 0 0 0 0 1.0 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 9 Jess Mruzik OH 5 26 5 70 0.300 2 1 3 12 46 5 0 1 1 27.5 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 11 Jocelyn Nathan L/DS 5 0 0 0 0.000 0 0 0 6 7 0 0 0 0 0.0 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 21 Izzy Starck S 5 2 2 9 0.000 56 1 3 11 0 0 0 2 0 4.0 1
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away 1 Taylor Trammell MB 5 5 2 13 0.231 0 0 0 1 0 0 1 4 1 8.0 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away NA TEAM 0 0 0 0 0.000 0 0 0 0 0 0 0 0 0 0.0 0
2024-2025 2024-12-19 Penn St. Big Ten Nebraska Big Ten Away NA Penn St. 5 71 26 186 0.242 69 7 14 66 105 6 3 14 2 88.0 1
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 5 Rebekah Allick MB 5 8 2 17 0.353 1 0 0 1 0 0 2 8 0 14.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 13 Merritt Beason OH 5 8 2 29 0.207 0 1 1 4 0 0 0 3 1 10.5 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 6 Laney Choboy L/DS 5 0 0 0 0.000 0 0 0 6 14 0 0 0 0 0.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 15 Andi Jackson MB 5 19 2 27 0.630 0 0 0 0 0 0 0 5 0 21.5 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 12 Taylor Landfair OH 5 10 5 29 0.172 0 0 0 2 2 0 0 3 0 11.5 1
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 10 Olivia Mauch L/DS 5 0 0 0 0.000 0 1 1 9 37 1 0 0 0 1.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 27 Harper Murray OH 5 20 10 58 0.172 1 3 3 15 26 4 0 6 1 26.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 9 Kennedi Orr S 5 0 0 0 0.000 0 1 0 5 0 0 0 0 0 1.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 2 Bergen Reilly S 5 0 1 4 -0.250 55 0 1 15 1 0 0 1 1 0.5 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 8 Lexi Rodriguez L/DS 5 0 0 0 0.000 5 0 1 15 14 1 0 0 0 0.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home NA TEAM 0 0 0 0 0.000 0 0 0 0 0 1 0 0 0 0.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home NA Nebraska 5 65 22 164 0.262 62 6 7 72 95 7 2 26 3 86.0 1

This returns a list with two elements—one for each team. If we just want to return a single team’s match stats, we can specify this with the team argument. Also, by default, the team stats are included in the output, but we can remove these with team_stats = FALSE.

player_match_stats(contest = "6080708", team = "Nebraska", team_stats = FALSE)
Season Date Team Conference Opponent Team Opponent Conference Location Number Player P S Kills Errors TotalAttacks HitPct Assists Aces SErr Digs RetAtt RErr BlockSolos BlockAssists BErr PTS BHE
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 5 Rebekah Allick MB 5 8 2 17 0.353 1 0 0 1 0 0 2 8 0 14.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 13 Merritt Beason OH 5 8 2 29 0.207 0 1 1 4 0 0 0 3 1 10.5 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 6 Laney Choboy L/DS 5 0 0 0 0.000 0 0 0 6 14 0 0 0 0 0.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 15 Andi Jackson MB 5 19 2 27 0.630 0 0 0 0 0 0 0 5 0 21.5 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 12 Taylor Landfair OH 5 10 5 29 0.172 0 0 0 2 2 0 0 3 0 11.5 1
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 10 Olivia Mauch L/DS 5 0 0 0 0.000 0 1 1 9 37 1 0 0 0 1.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 27 Harper Murray OH 5 20 10 58 0.172 1 3 3 15 26 4 0 6 1 26.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 9 Kennedi Orr S 5 0 0 0 0.000 0 1 0 5 0 0 0 0 0 1.0 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 2 Bergen Reilly S 5 0 1 4 -0.250 55 0 1 15 1 0 0 1 1 0.5 0
2024-2025 2024-12-19 Nebraska Big Ten Penn St. Big Ten Home 8 Lexi Rodriguez L/DS 5 0 0 0 0.000 5 0 1 15 14 1 0 0 0 0.0 0

Play-by-play data

Play-by-play data for matches are also available on the NCAA’s website, if you know the contest ID. The match_pbp() function extracts relevant events within a match.

match_pbp(contest = "6080708") |>
  head(20) # cut this off, because it has 1525 rows!
set away_team home_team score team event player description
1 Penn St. Nebraska 0-0 Penn St. Serve Jocelyn Nathan Jocelyn Nathan serves
1 Penn St. Nebraska 0-0 Nebraska Reception Bergen Reilly Reception by Bergen Reilly
1 Penn St. Nebraska 0-0 Nebraska Set Lexi Rodriguez Set by Lexi Rodriguez
1 Penn St. Nebraska 0-0 Nebraska Attack Merritt Beason Attack by Merritt Beason
1 Penn St. Nebraska 0-0 Nebraska Set Bergen Reilly Set by Bergen Reilly
1 Penn St. Nebraska 0-0 Nebraska Attack Harper Murray Attack by Harper Murray
1 Penn St. Nebraska 0-0 Penn St. Dig Gillian Grimes Dig by Gillian Grimes
1 Penn St. Nebraska 0-0 Penn St. Set Izzy Starck Set by Izzy Starck
1 Penn St. Nebraska 0-0 Penn St. Attack Taylor Trammell Attack by Taylor Trammell
1 Penn St. Nebraska 0-0 Nebraska Block Rebekah Allick Block by Rebekah Allick
1 Penn St. Nebraska 0-1 Nebraska Block Rebekah Allick Block by Rebekah Allick
1 Penn St. Nebraska 0-1 Nebraska Serve Lexi Rodriguez Lexi Rodriguez serves
1 Penn St. Nebraska 0-1 Penn St. Reception Jess Mruzik Reception by Jess Mruzik
1 Penn St. Nebraska 0-1 Penn St. Set Izzy Starck Set by Izzy Starck
1 Penn St. Nebraska 0-1 Penn St. Attack Jess Mruzik Attack by Jess Mruzik
1 Penn St. Nebraska 0-1 Nebraska Dig Harper Murray Dig by Harper Murray
1 Penn St. Nebraska 0-1 Penn St. Set Izzy Starck Set by Izzy Starck
1 Penn St. Nebraska 0-1 Penn St. Attack Caroline Jurevicius Attack by Caroline Jurevicius
1 Penn St. Nebraska 1-1 Penn St. Kill Caroline Jurevicius Kill by Caroline Jurevicius
1 Penn St. Nebraska 1-1 Penn St. Serve Gillian Grimes Gillian Grimes serves

Aggregating data

Though the season, match, and play-by-play data are useful at the individual level, they can be more useful when aggregated. The group_stats() function aggregates season, match, and play-by-play data over multiple teams and/or years by applying the player_season_stats(), player_match_stats(), or match_pbp() across teams and years.

group_stats(teams = c("Nebraska", "Wisconsin"), year = 2023:2024, level = "season")
#> $playerdata
#> # A tibble: 54 × 30
#>    Season    Team   Conference Number Player Yr    Pos   Ht       GP    GS     S
#>    <chr>     <chr>  <chr>       <dbl> <chr>  <chr> <chr> <chr> <dbl> <dbl> <dbl>
#>  1 2023-2024 Nebra… Big Ten         2 Berge… Fr    S     6-1      35    35   121
#>  2 2023-2024 Nebra… Big Ten         5 Rebek… So    MB    6-4      32    31   105
#>  3 2023-2024 Nebra… Big Ten         6 Laney… Fr    L/DS  5-3      34    33   117
#>  4 2023-2024 Nebra… Big Ten         7 Maisi… So    L/DS  5-6      18     0    36
#>  5 2023-2024 Nebra… Big Ten         8 Lexi … Jr    L/DS  5-5      35     0   121
#>  6 2023-2024 Nebra… Big Ten         9 Kenne… Jr    S     6-0      29     0    96
#>  7 2023-2024 Nebra… Big Ten        11 Hayde… So    OH    6-2       9     0    10
#>  8 2023-2024 Nebra… Big Ten        13 Merri… Jr    OH    6-4      35    35   121
#>  9 2023-2024 Nebra… Big Ten        14 Ally … Jr    OH    6-5      30     2    87
#> 10 2023-2024 Nebra… Big Ten        15 Andi … Fr    MB    6-3      34    34   118
#> # ℹ 44 more rows
#> # ℹ 19 more variables: Kills <dbl>, Errors <dbl>, `Total Attacks` <dbl>,
#> #   `Hit Pct` <dbl>, Assists <dbl>, Aces <dbl>, SErr <dbl>, Digs <dbl>,
#> #   RetAtt <dbl>, RErr <dbl>, `Block Solos` <dbl>, `Block Assists` <dbl>,
#> #   BErr <dbl>, PTS <dbl>, BHE <dbl>, `Trpl Dbl` <dbl>, `Dbl Dbl` <dbl>,
#> #   Hometown <chr>, `High School` <chr>
#> 
#> $teamdata
#> # A tibble: 4 × 23
#>   Season   Team  Conference     S Kills Errors `Total Attacks` `Hit Pct` Assists
#>   <chr>    <chr> <chr>      <dbl> <dbl>  <dbl>           <dbl>     <dbl>   <dbl>
#> 1 2023-20… Nebr… Big Ten      121  1676    597            3959     0.273    1553
#> 2 2024-20… Nebr… Big Ten      122  1721    551            4114     0.284    1596
#> 3 2023-20… Wisc… Big Ten      119  1654    428            3950     0.31     1552
#> 4 2024-20… Wisc… Big Ten      120  1657    486            4090     0.286    1562
#> # ℹ 14 more variables: Aces <dbl>, SErr <dbl>, Digs <dbl>, RetAtt <dbl>,
#> #   RErr <dbl>, `Block Solos` <dbl>, `Block Assists` <dbl>, BErr <dbl>,
#> #   PTS <dbl>, BHE <dbl>, `Trpl Dbl` <dbl>, `Dbl Dbl` <dbl>, Hometown <chr>,
#> #   `High School` <chr>

We don’t have other examples, because these take a while to run.

There are also convenience functions conference_stats() and division_stats() that automatically extract data for a particular conference or NCAA division.

conference_stats(year = 2024, conf = "Big Ten", level = "season")
#> $playerdata
#> # A tibble: 274 × 29
#>    Season    Team     Conference Number Player        Yr    Pos   Ht    Hometown
#>    <chr>     <chr>    <chr>       <dbl> <chr>         <chr> <chr> <chr> <chr>   
#>  1 2024-2025 Illinois Big Ten         2 Raegen Reilly Sr    S     5-10  Sioux F…
#>  2 2024-2025 Illinois Big Ten         3 Lily Barry    So    L/DS  5-6   Emden, …
#>  3 2024-2025 Illinois Big Ten         4 Bianca May    So    S     5-8   Orland …
#>  4 2024-2025 Illinois Big Ten         5 Taylor de Bo… Fr    OH    6-4   Kelowna…
#>  5 2024-2025 Illinois Big Ten         8 Averie Herna… Jr    OH    6-2   Bloomin…
#>  6 2024-2025 Illinois Big Ten        10 Caroline Bar… Sr    L/DS  5-11  Napervi…
#>  7 2024-2025 Illinois Big Ten        11 Cari Bohm     So    MB    6-4   Ann Arb…
#>  8 2024-2025 Illinois Big Ten        12 Raina Terry   Sr    OH    6-1   Marengo…
#>  9 2024-2025 Illinois Big Ten        13 Kenzie Cogan  Fr    L/DS  5-7   Cincinn…
#> 10 2024-2025 Illinois Big Ten        16 Ashlyn Philp… Fr    MB    6-4   Greenvi…
#> # ℹ 264 more rows
#> # ℹ 20 more variables: `High School` <chr>, GP <dbl>, GS <dbl>, S <dbl>,
#> #   Kills <dbl>, Errors <dbl>, `Total Attacks` <dbl>, `Hit Pct` <dbl>,
#> #   Assists <dbl>, Aces <dbl>, SErr <dbl>, Digs <dbl>, RetAtt <dbl>,
#> #   RErr <dbl>, `Block Solos` <dbl>, `Block Assists` <dbl>, BErr <dbl>,
#> #   PTS <dbl>, BHE <dbl>, `Trpl Dbl` <dbl>
#> 
#> $teamdata
#> # A tibble: 18 × 20
#>    Season  Team  Conference     S Kills Errors `Total Attacks` `Hit Pct` Assists
#>    <chr>   <chr> <chr>      <dbl> <dbl>  <dbl>           <dbl>     <dbl>   <dbl>
#>  1 2024-2… Illi… Big Ten      114  1432    559            3793     0.23     1311
#>  2 2024-2… Indi… Big Ten      108  1384    595            3774     0.209    1283
#>  3 2024-2… Iowa  Big Ten      119  1440    678            4024     0.189    1313
#>  4 2024-2… Mary… Big Ten      112  1322    566            3722     0.203    1197
#>  5 2024-2… Mich… Big Ten      117  1535    628            4081     0.222    1436
#>  6 2024-2… Mich… Big Ten      114  1399    604            3877     0.205    1275
#>  7 2024-2… Minn… Big Ten      122  1581    560            4226     0.242    1441
#>  8 2024-2… Nebr… Big Ten      122  1721    551            4114     0.284    1596
#>  9 2024-2… Nort… Big Ten      106  1202    601            3488     0.172    1103
#> 10 2024-2… Ohio… Big Ten      117  1476    641            4086     0.204    1383
#> 11 2024-2… Oreg… Big Ten      117  1554    531            3915     0.261    1442
#> 12 2024-2… Penn… Big Ten      135  1972    648            4673     0.283    1841
#> 13 2024-2… Purd… Big Ten      118  1683    509            4191     0.28     1568
#> 14 2024-2… Rutg… Big Ten      104  1145    540            3441     0.176    1080
#> 15 2024-2… Sout… Big Ten      122  1597    622            4091     0.238    1469
#> 16 2024-2… UCLA  Big Ten      109  1474    544            3766     0.247    1373
#> 17 2024-2… Wash… Big Ten      117  1494    601            3970     0.225    1400
#> 18 2024-2… Wisc… Big Ten      120  1657    486            4090     0.286    1562
#> # ℹ 11 more variables: Aces <dbl>, SErr <dbl>, Digs <dbl>, RetAtt <dbl>,
#> #   RErr <dbl>, `Block Solos` <dbl>, `Block Assists` <dbl>, BErr <dbl>,
#> #   PTS <dbl>, BHE <dbl>, `Trpl Dbl` <dbl>

Well, that covers most of the functionality of {ncaavolleyballr}. If you find any bugs or have any questions, please reach out.