Advertisement

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:
http://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.
NameDescriptionSample Values
key*Your API keymyAPIkey
state*2 letter state abbreviation CT
zip5 digit zip code 06107
cityURL-encoded city name San+Francisco
addressURL-encoded address 684+New+Britain+Ave
latlatitude 37.758862
lonlongitude -122.411406
schoolTypeType of school you wish to appear in the listValid values: "public", "charter", "private", or any combination separated by hyphens, like "public-charter"
levelCodeLevel of school you wish to appear in the listValid values: "elementary-schools", "middle-schools", "high-schools"
minimumSchoolsMinimum # of schools to return. When provided, if the initial query field yields fewer schools than this value, the radius will be increased in 5 mile increments to a maximum of 50 miles or until the result set has enough schools to meet this value.
Maximum value is 200.
This value must be less than the limit or else it is ignored.
50
radiusMiles radius to confine search to.
default: 5
maximum: 50
limitMaximum number of schools to return. This defaults to 200. 100
*required
Examples of usage:
http://api.greatschools.org/schools/nearby?key=[yourAPIKey]&address=160+Spear+St&city=San+Francisco&state=CA&zip=94105&schoolType=public-charter&levelCode=elementary-schools&minimumSchools=50&radius=10&limit=100
Returns 50 to 100 public and charter elementary schools within 10 miles of 160 Spear St, San Francisco, CA 94105
http://api.greatschools.org/schools/nearby?key=[yourAPIKey]&city=San+Francisco&state=CA
Returns up to 200 schools within 5 miles of San Francisco, CA
http://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
http://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

http://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.