School Digger

GET https://api.schooldigger.com/v1.2/schools?st=CA&perPage=50&level =high&appID=demo-id&appKey=demo-key

Displays the n counties with the largest number of schools as a bar chart. n is specified by the user, and counted from the JSON response.

Sample JSON response { "numberOfSchools": 12879, "numberOfPages": 258, "schoolList": [ { "schoolid": "060429013779", "schoolName": "21st Century Learning Institute", "phone": "(951) 769-8424", "url": "https://www.schooldigger.com/go/CA/schools/0429013779/school.aspx", "urlCompare": "https://www.schooldigger.com/go/CA/schools/0429013779/search.aspx", "address": { "latLong": { "latitude": 33.934277, "longitude": -116.969275 }, "street": "939 E. 10th St.", "city": "Beaumont", "state": "CA", "stateFull": "California", "zip": "92223", "zip4": "1927", "cityURL": "https://www.schooldigger.com/go/CA/city/Beaumont/search.aspx", "zipURL": "https://www.schooldigger.com/go/CA/zip/92223/search.aspx", "html": "939 E. 10th St.<br />Beaumont, CA 92223-1927" }, "lowGrade": "K", "highGrade": "12", "schoolLevel": "Other", "isCharterSchool": "No", "isMagnetSchool": "No", "isVirtualSchool": "Yes", "isTitleISchool": "No", "isTitleISchoolwideSchool": "No", "district": { "districtID": "0604290", "districtName": "Beaumont Unified", "url": "https://www.schooldigger.com/go/CA/district/04290/search.aspx", "rankURL": "https://www.schooldigger.com/go/CA/districtrank.aspx?finddistrict=04290" }, "county": { "countyName": "Riverside", "countyURL": "https://www.schooldigger.com/go/CA/county/Riverside/search.aspx" }, "rankHistory": null, "rankMovement": null, "locationIsWithinBoundary": null, "schoolYearlyDetails": [ { "year": 2017, "numberOfStudents": 87, "percentFreeDiscLunch": 42.53, "percentofAfricanAmericanStudents": 13.79, "percentofAsianStudents": 2.30, "percentofHispanicStudents": 41.38, "percentofIndianStudents": 0.0, "percentofPacificIslanderStudents": 0.0, "percentofWhiteStudents": 42.53, "percentofTwoOrMoreRaceStudents": 0.0, "percentofUnspecifiedRaceStudents": null, "teachersFulltime": 2.9, "pupilTeacherRatio": 29.1, "numberofAfricanAmericanStudents": 12, "numberofAsianStudents": 2, "numberofHispanicStudents": 36, "numberofIndianStudents": 0, "numberofPacificIslanderStudents": 0, "numberofWhiteStudents": 37, "numberofTwoOrMoreRaceStudents": 0, "numberofUnspecifiedRaceStudents": null }, { "year": 2016, "numberOfStudents": 73, "percentFreeDiscLunch": 52.05, "percentofAfricanAmericanStudents": 12.33, "percentofAsianStudents": 0.0, "percentofHispanicStudents": 45.21, "percentofIndianStudents": 0.0, "percentofPacificIslanderStudents": 0.0, "percentofWhiteStudents": 42.47, "percentofTwoOrMoreRaceStudents": 0.0, "percentofUnspecifiedRaceStudents": null, "teachersFulltime": 3.0, "pupilTeacherRatio": 24.3, "numberofAfricanAmericanStudents": 9, "numberofAsianStudents": 0, "numberofHispanicStudents": 33, "numberofIndianStudents": 0, "numberofPacificIslanderStudents": 0, "numberofWhiteStudents": 31, "numberofTwoOrMoreRaceStudents": 0, "numberofUnspecifiedRaceStudents": null } ], "isPrivate": false, "privateDays": null, "privateHours": null, "privateHasLibrary": null, "privateCoed": null, "privateOrientation": null, "hasBoundary": false }, { "schoolid": "069999953556", "schoolName": "9 Fruits Learning Center", "phone": "(650) 962-1900", "url": "https://www.schooldigger.com/go/CA/schools/9999953556/school.aspx", "urlCompare": "https://www.schooldigger.com/go/CA/schools/9999953556/search.aspx", "address": { "latLong": { "latitude": 37.415424, "longitude": -122.099278 }, "street": "2484 Old Middle Field Way", "city": "Mountain View", "state": "CA", "stateFull": "California", "zip": "94043", "zip4": "", "cityURL": "https://www.schooldigger.com/go/CA/city/Mountain+View/search.aspx", "zipURL": "https://www.schooldigger.com/go/CA/zip/94043/search.aspx", "html": "2484 Old Middle Field Way<br />Mountain View, CA 94043" }, "lowGrade": "K", "highGrade": "6", "schoolLevel": "Private", "isCharterSchool": "(n/a)", "isMagnetSchool": "(n/a)", "isVirtualSchool": "(n/a)", "isTitleISchool": "(n/a)", "isTitleISchoolwideSchool": "(n/a)", "county": { "countyName": "Santa Clara", "countyURL": "https://www.schooldigger.com/go/CA/county/Santa+Clara/search.aspx" }, "rankHistory": null, "rankMovement": null, "locationIsWithinBoundary": null, "schoolYearlyDetails": [ { "year": 2018, "numberOfStudents": 205, "percentFreeDiscLunch": null, "percentofAfricanAmericanStudents": 0.0, "percentofAsianStudents": 91.22, "percentofHispanicStudents": 0.49, "percentofIndianStudents": 0.0, "percentofPacificIslanderStudents": 0.0, "percentofWhiteStudents": 2.93, "percentofTwoOrMoreRaceStudents": 5.37, "percentofUnspecifiedRaceStudents": null, "teachersFulltime": 11.4, "pupilTeacherRatio": 17.9, "numberofAfricanAmericanStudents": 0, "numberofAsianStudents": 187, "numberofHispanicStudents": 1, "numberofIndianStudents": 0, "numberofPacificIslanderStudents": 0, "numberofWhiteStudents": 6, "numberofTwoOrMoreRaceStudents": 11, "numberofUnspecifiedRaceStudents": null }, { "year": null, "numberOfStudents": null, "percentFreeDiscLunch": null, "percentofAfricanAmericanStudents": null, "percentofAsianStudents": null, "percentofHispanicStudents": null, "percentofIndianStudents": null, "percentofPacificIslanderStudents": null, "percentofWhiteStudents": null, "percentofTwoOrMoreRaceStudents": null, "percentofUnspecifiedRaceStudents": null, "teachersFulltime": null, "pupilTeacherRatio": null, "numberofAfricanAmericanStudents": null, "numberofAsianStudents": null, "numberofHispanicStudents": null, "numberofIndianStudents": null, "numberofPacificIslanderStudents": null, "numberofWhiteStudents": null, "numberofTwoOrMoreRaceStudents": null, "numberofUnspecifiedRaceStudents": null } ], "isPrivate": true, "privateDays": 245, "privateHours": 6.0, "privateHasLibrary": false, "privateCoed": "Coed", "privateOrientation": "Nonsectarian", "hasBoundary": null }, ... ] }

Sample Bar Chart

alt text

Request Params

KeyDatatypeRequiredDescription
ststring
perPagenumber
level string
appIDstring
appKeystring