get_schools
Search schools with enrollment, Title I status, type (charter/magnet/regular), and teacher counts.
Returns school directory information from the Common Core of Data (CCD),
including school name, location, enrollment, charter/magnet status,
Title I participation, and full-time equivalent teacher counts.
Args:
state: Two-letter US state abbreviation (e.g. 'CA', 'NY').
county_fips: Optional 5-digit county FIPS code to filter by county.
title_i_only: If True, return only Title I eligible schools.
year: School year to query (default 2022).
limit: Maximum number of schools to return (default 50, max 500).
get_district_finance
Get district-level financial data: total revenue, expenditures, per-pupil spending, federal/state/local revenue breakdown.
Returns fiscal data from the CCD School District Finance Survey (F-33),
including revenue sources, expenditure categories, and per-pupil spending.
Args:
state: Two-letter US state abbreviation (e.g. 'CA', 'NY').
county_fips: Optional 5-digit county FIPS code to filter by county.
year: Fiscal year to query (default 2021). Finance data lags 1-2 years.
limit: Maximum number of districts to return (default 50, max 500).
get_graduation_rates
Get 4-year adjusted cohort graduation rates by school.
Returns graduation rate data from EdFacts, including cohort counts
and midpoint graduation rates. Filterable by state or county.
Args:
state: Two-letter US state abbreviation (e.g. 'CA', 'NY').
county_fips: Optional 5-digit county FIPS code to filter by county.
year: School year to query (default 2021). Graduation data may lag.
limit: Maximum number of schools to return (default 50, max 500).
get_school_demographics
Get school enrollment broken down by race/ethnicity.
Returns enrollment counts by demographic group from the CCD,
including White, Black, Hispanic, Asian, Native American,
Pacific Islander, Two or More Races, and total enrollment.
Args:
state: Two-letter US state abbreviation (e.g. 'CA', 'NY').
county_fips: Optional 5-digit county FIPS code to filter by county.
year: School year to query (default 2022).
limit: Maximum number of schools to return (default 50, max 500).
get_district_overview
Get district directory overview: district name, student count, school count, teachers, locale type.
Returns district-level summary information from the CCD District Directory,
including total enrollment, number of schools, teacher FTE counts,
and urban/suburban/rural locale classification.
Args:
state: Two-letter US state abbreviation (e.g. 'CA', 'NY').
year: School year to query (default 2022).
limit: Maximum number of districts to return (default 50, max 500).