US News Rankings Scraper

Scrape rankings from US News & World Report — the most trusted source for university, hospital, high school, and graduate school rankings in the United States.

What You Can Scrape

• Universities — National universities, liberal arts colleges, regional universities/colleges, engineering programs, business programs, nursing schools, and more
• Hospitals — Top-ranked hospitals by medical specialty (cancer, cardiology, neurology, orthopedics, and 12 more)
• High Schools — Best high school rankings nationally or by state (public schools, ranked)
• Private High Schools — Private-school directory nationally or by state, including tuition and financial aid where published (unranked — see FAQ)
• Graduate Schools — MBA, law, medicine, engineering, education, and public affairs programs

Input Parameters

Parameter	Type	Description	Default
mode	Select	Rankings type: universities, hospitals, highSchools, privateHighSchools, gradSchools	universities
rankingType	Select	University ranking list (mode=universities)	national-universities
specialty	Select	Hospital specialty (mode=hospitals)	cancer
subject	Select	Graduate school subject (mode=gradSchools)	business
state	Select	Filter by US state abbreviation (e.g. CA, TX, NY)	All states
maxItems	Integer	Maximum records to return (1–2000)	50

University Ranking Types

• National Universities
• National Liberal Arts Colleges
• Regional Universities (North/South/Midwest/West)
• Regional Colleges (North/South/Midwest/West)
• Best Business Programs
• Best Engineering Programs
• Best Computer Science Programs
• Best Nursing Programs
• Historically Black Universities
• Online Bachelor's Programs
• Best Value Schools

Hospital Specialties

Cancer, Cardiology & Heart Surgery, Diabetes & Endocrinology, Ear/Nose/Throat, Gastroenterology, Geriatric Care, Gynecology, Nephrology, Neurology & Neurosurgery, Ophthalmology, Orthopedics, Psychiatry, Pulmonology, Rehabilitation, Rheumatology, Urology

Output Fields

University Records

Field	Type	Description
rank	Integer	National/regional ranking position
name	String	Institution name
url	String	US News profile URL
imageUrl	String	Campus photo URL
city	String	City
state	String	State abbreviation
zipCode	String	ZIP/postal code
type	String	Public or Private
description	String	School summary blurb (institution type, founding info, setting, notable programs)
tuition	Integer	Annual tuition and fees (USD)
tuitionUnit	String	"annual"
tuitionPerCredit	Integer	Per-credit-hour tuition (USD) — only present for rankingType=online-programs-bachelors, which prices by credit rather than annually
enrollmentCount	Integer	Undergraduate enrollment
acceptanceRate	Float	Acceptance rate (%)
overallScore	Float	US News composite score
netCost	Integer	Average net cost after aid (USD)
percentReceivingAid	Float	% of students receiving need-based aid
avgGpa	Float	Average high school GPA
satScore	Integer	SAT 25th percentile composite score
satRange	String	SAT score range (e.g. "1510-1580")
actScore	Integer	ACT 25th percentile composite score
actRange	String	ACT score range (e.g. "34-36")
programReputationScores	Object	Undergraduate program peer-assessment reputation scores (1.0–5.0) by field — e.g. engineering, business, computerScience, nursing, psychology, economics (only programs the school offers are included)
rankingType	String	Ranking category name
rankingYear	String	Ranking year
sourceUrl	String	Ranking page URL
scrapedAt	String	ISO 8601 timestamp
recordType	String	"university"

Hospital Records

Field	Type	Description
rank	Integer	National specialty ranking
name	String	Hospital name
url	String	US News hospital profile URL
imageUrl	String	Hospital thumbnail photo URL
city	String	City
state	String	State abbreviation
zipCode	String	ZIP/ZIP+4 postal code
specialty	String	Medical specialty
score	Float	US News composite score (0-100)
description	String	Brief hospital description
phone	String	Contact phone number
rankingYear	String	Ranking year
sourceUrl	String	Ranking page URL
scrapedAt	String	ISO 8601 timestamp
recordType	String	"hospital"

High School Records

Field	Type	Description
rank	Integer	State ranking position
name	String	School name
url	String	US News profile URL
city	String	City
state	String	State abbreviation
district	String	School district name
districtUrl	String	US News district profile URL
description	String	Brief school description
graduationRate	Float	Graduation rate (%)
collegeReadinessIndex	Float	US News College Readiness Index
enrollmentCount	Integer	Student enrollment
rankingType	String	"High Schools"
sourceUrl	String	Ranking page URL
scrapedAt	String	ISO 8601 timestamp
recordType	String	"highSchool"

Private High School Records

Field	Type	Description
name	String	School name
url	String	US News K-12 directory profile URL
city	String	City
state	String	State abbreviation
gradeLevel	String	Grades served, e.g. "9-12"
enrollmentCount	Integer	Student enrollment
studentTeacherRatio	String	e.g. "11:1"
description	String	Brief school description
streetAddress	String	Full street address including ZIP — only where the school's profile publishes it
classroomTeachersCount	Integer	Number of classroom teachers — only where published
averageClassSize	Integer	Average class size — only where published
sportsOffered	Array of strings	Sports/athletics programs offered — only where published
yearlyTuition	Integer	Annual tuition (USD) — only where the school's profile publishes it
fees	Integer	Annual fees (USD) — only where published
financialAidAvailable	String	"Yes"/"No" — only where published
apCoursesOffered	String	"Yes"/"No" — only where published
sourceUrl	String	Directory listing page URL
scrapedAt	String	ISO 8601 timestamp
recordType	String	"privateHighSchool"

Graduate School Records

Field	Type	Description
rank	Integer	Ranking position within subject
name	String	Institution name
url	String	US News profile URL
city	String	City
state	String	State abbreviation
imageUrl	String	Campus photo URL
description	String	Brief program description (tuition, deadlines, faculty ratio, etc.)
subject	String	Graduate subject (e.g. "Medicine", "Law")
sourceUrl	String	Ranking page URL
scrapedAt	String	ISO 8601 timestamp
recordType	String	"gradSchool"

Example Input

{
  "mode": "universities",
  "rankingType": "national-universities",
  "maxItems": 20
}

{
  "mode": "hospitals",
  "specialty": "cancer",
  "state": "CA",
  "maxItems": 10
}

{
  "mode": "privateHighSchools",
  "state": "CA",
  "maxItems": 25
}

{
  "mode": "gradSchools",
  "subject": "law",
  "maxItems": 25
}

FAQs

Q: How current are the rankings? A: Rankings are updated annually by US News. The scraper returns the current published rankings (2026 edition).

Q: Can I filter by state? A: Yes! Use the state parameter with a 2-letter abbreviation (e.g. CA, TX, NY) to filter any ranking type by state.

Q: How many hospitals are ranked per specialty? A: US News typically ranks 10-50 hospitals per specialty nationally. Some specialties may have more results.

Q: Are SAT scores and GPA available? A: Yes, for universities where US News reports them. Some data may be missing for schools that don't report.

Q: Can I scrape all university ranking types? A: Yes, set mode=universities and select any rankingType from the dropdown. Each list can have 100+ schools.

Q: Why don't private high school records have a rank, graduationRate, or collegeReadinessIndex? A: US News does not rank private high schools — its "Best High Schools" methodology depends on state accountability-test data that private schools aren't required to report. mode=privateHighSchools instead returns US News' separate, unranked private-school directory, which carries a different set of fields (tuition, enrollment, student-teacher ratio) rather than ranking metrics.

Q: Why are yearlyTuition/fees/financialAidAvailable/apCoursesOffered missing for some private schools? A: These fields only exist on a school's own US News profile page, and only for schools that have published/claimed their profile. Unclaimed profiles simply omit these fields rather than returning placeholder values.

Q: Why does rankingType=online-programs-bachelors have fewer fields than other university rankings (no acceptanceRate, satScore, avgGpa, programReputationScores)? A: US News publishes this ranking on a separate product/vertical (usnews.com/education/online-education) from its standard college-search rankings, with a different data model geared toward online/distance programs rather than traditional admissions — those metrics simply aren't part of that data set. It also reports tuition per credit-hour (tuitionPerCredit) rather than annually (tuition), since online programs are typically priced per credit.

Q: What is the data source? A: All data is scraped from www.usnews.com — the official US News & World Report rankings website. No API key required.