GreatSchools K-12 School Ratings Scraper

Scrape school ratings, test scores, demographics, and reviews from GreatSchools for over 200,000 preK-12 schools in the United States.

Features

• Search by zip code, city, or address
• GreatSchools ratings (1-10 scale)
• Test score subratings
• Demographic breakdowns
• Parent reviews and ratings
• Enrollment data
• Filter by school type and grade level

Output Fields

Field	Type	Description
schoolId	number	GreatSchools internal ID
name	string	School name
gsRating	number	GreatSchools rating (1-10)
address	object	Street, city, state, zip
lat/lon	number	Geographic coordinates
schoolType	string	Public, charter, or private
levelCode	string	e (elementary), m (middle), h (high)
gradeRange	string	e.g., "K-5", "6-8", "9-12"
districtName	string	School district name
enrollment	number	Total student enrollment
studentsPerTeacher	number	Student-teacher ratio
parentRating	number	Average parent review rating
numReviews	number	Number of parent reviews
subratings	object	Detailed ratings (Test Scores, Academic Progress, etc.)
demographics	object	Ethnic breakdown percentages
percentLowIncome	number	Percentage of low-income students

Example Output

{
    "schoolId": 1523,
    "name": "Beverly Hills High School",
    "gsRating": 9,
    "address": {
        "street": "241 S Moreno Dr",
        "city": "Beverly Hills",
        "state": "CA",
        "zipCode": "90212"
    },
    "lat": 34.0612,
    "lon": -118.4076,
    "schoolType": "public",
    "levelCode": "h",
    "gradeRange": "9-12",
    "districtName": "Beverly Hills Unified",
    "enrollment": 1521,
    "studentsPerTeacher": 16,
    "parentRating": 4.5,
    "numReviews": 42,
    "subratings": {
        "Test Scores": 10,
        "Academic Progress": 8,
        "College Readiness": 9
    },
    "demographics": {
        "White": 45,
        "Asian": 22,
        "Hispanic": 18,
        "Black": 8,
        "Two or more races": 5
    },
    "percentLowIncome": 12,
    "scrapedAt": "2024-01-20T10:30:00.000Z"
}

Understanding Ratings

GreatSchools Summary Rating (1-10)

• 7-10: Above average schools
• 5-6: Average schools
• 1-4: Below average schools

Subratings Include:

• Test Scores: State test performance vs. state average
• Academic Progress: Student growth over time
• College Readiness: College-preparedness indicators (high schools)
• Equity: Performance across student groups

Use Cases

• Real estate school district analysis
• School comparison tools
• Education research
• Neighborhood quality assessment
• Relocation assistance tools

Input Options

• searchQueries: Zip codes, cities, or addresses to search
• schoolTypes: Filter by "public", "charter", or "private"
• gradeLevels: Filter by "elementary", "middle", or "high"
• maxResultsPerSearch: Limit results per search query
• includeDetails: Include subratings and demographics

Legal

This scraper extracts publicly available information from GreatSchools.org. Please review their terms of service for commercial usage requirements.