Nearby Schools

Returns a list of schools closest to the center of a city, ZIP Code or address. All calls for Nearby Schools are in this format:
https://api.greatschools.org/schools/nearby?[parameters]

Parameters

The "key" parameter is what is used to identify your specific API key to GreatSchools. The "state" parameter tells us what State you would like the results for and is required. You must provide at least one of the following, "city", "zip", "address", or "lat" and "lon" describing the location in order to receive the list of schools near that coordinate. Other parameters are optional.
Name Description Sample Values
key* Your API key myAPIkey
state* 2 letter state abbreviation CT
zip 5 digit zip code 06107
city URL-encoded city name San+Francisco
address URL-encoded address 684+New+Britain+Ave
lat latitude 37.758862
lon longitude -122.411406
schoolType Type of school you wish to appear in the list Valid values: "public", "charter", "private", or any combination separated by hyphens, like "public-charter"
levelCode Level of school you wish to appear in the list Valid values: "elementary-schools", "middle-schools", "high-schools"
radius Miles radius to confine search to.
default: 5
maximum: 50
limit Maximum number of schools to return. This defaults to 200. 100
*required
Examples of usage:
https://api.greatschools.org/schools/nearby?key=[yourAPIKey]&address=160+Spear+St&city=San+Francisco&state=CA&zip=94105&schoolType=public-charter&levelCode=elementary-schools&radius=10&limit=100
Returns up to 100 public and charter elementary schools within 10 miles of 160 Spear St, San Francisco, CA 94105
https://api.greatschools.org/schools/nearby?key=[yourAPIKey]&city=San+Francisco&state=CA
Returns up to 200 schools within 5 miles of San Francisco, CA
https://api.greatschools.org/schools/nearby?key=[yourAPIKey]&state=CA&zip=94105
Returns up to 200 schools within 5 miles of ZIP Code 94105 in California
https://api.greatschools.org/schools/nearby?key=[yourAPIKey]&state=CA&lat=37.758862&lon=-122.411406
Returns up to 200 schools within 5 miles of latitude 35.274494, longitude -119.005623 in California

Sample Request

https://api.greatschools.org/schools/nearby?key=[yourAPIKey]&state=CA&zip=94105&limit=2
Returns 2 California schools within 5 miles of ZIP Code 94105 in California

Sample Response

Have Questions?

To ask questions or to report bugs please email api-support@greatschools.org. Please do not abuse our API. Review the Terms of Use.

Top