Overview

USAU (USA Ultimate) is the governing body of ultimate frisbee, and its website (which is notoriously hard to navigate) contains all of the information about high school, college, and club ultimate frisbee teams. Right now, there is no easy way to access this data. USAU scraper solves this problem by scraping the USAU website for data and therefore allowing other developers to easily use the data on the USAU site. This project will open the door to more data analytic projects concerning ultimate frisbee.

usau-scraper allows developers to easily access:

  • Team roster, schedule, and results data.

  • Tournament results data, from all pool play results to just the first and second place winners of the tournament.

  • Rankings data for the college and club levels.

Installation

pip install --upgrade usau-scraper

How to Use

Simply from usau_scraper import *, and get started!

More extensive module documentation is here: package details

Example Usage

After pip install --upgrade usau-scraper in your python env:

from usau_scraper import *

# Get a team's basic information
print(getTeamInfo(
   schoolName = 'Columbia',
   teamName = 'Baewatch',
   genderDivision='Women',
   state='NY',
   competitionLevel='College',
   competitionDivision='Division 1',
   teamDesignation='B'))

# Get a team's schedule for the current season
print(getTeamSchedule(schoolName='Columbia', teamName='Curbside'))

# Get a team's roster for the current season
print(getTeamRoster(schoolName='Columbia', teamName='Curbside'))

# Get the pool play results for a tournament
print(getTournamentPoolPlayResults("College", "Women", eventName="No Sleep Till Brooklyn", season=2023))

# Get the bracket results for a tournament
print(getTournamentBracketResults("College", "Women", eventName="Centex", season=2022))

# Get the winner for a tournament
print(getTournamentWinner("College", "Women", eventName="Stanford Invite", season=2023))

# Get the top 20 women's college teams
print(getCollegeRankings(genderDivision="Women"))

# Get the top 20 women's club teams
print(getClubRankings(genderDivision="Women"))

# Print the schedule for each top 20 team
teams = getCollegeRankings(genderDivision="Women")["teams"]

for team in teams:
   print(json.dumps(getTeamSchedule(schoolName=team["Team"], genderDivision='Women', competitionLevel='College')["teams"][0], indent=4))

Additional usage examples are in this notebook.

Indices and tables