# GreatSchools API: Search schools near a location > Finds GreatSchools schools within 5 miles of a US address, city or ZIP code. Results can be filtered by grade and school type and sorted by distance or rating. Unofficial. Not affiliated with or endorsed by GreatSchools. - Page: https://fous.com/methods/greatschools.org/search-schools - Method: `greatschools.org/search_schools`, version 1 - Website: greatschools.org - Returns: school name, rating, grades, type, distance, address, enrollment, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | | Order results by proximity or GreatSchools rating, for example distance. One of "distance", "rating". Default "distance". | | `location` | string | yes | `"94107"` | US street address, city and state, or ZIP code, for example 94107. | | `grade_level` | string | no | | Grade range to include, for example elementary. One of "any", "preschool", "elementary", "middle", "high". Default "any". | | `max_results` | integer | no | | Maximum schools to return, for example 20. Default 20. | | `school_type` | string | no | | Type of school to include, for example public. One of "any", "public", "charter", "private". Default "any". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "location": "94107" } ``` Its output: ```json { "schools": [ { "type": "Private", "address": "465 Missouri St., San Francisco, CA 94107", "school_name": "Potrero Kids at Daniel Webster (PKDW) Preschool", "grades_served": "PK", "distance_miles": 0.11, "greatschools_link": "https://www.greatschools.org/california/san-francisco/25201-Potrero-Kids-At-Daniel-Webster-PKDW-Preschool/", "number_of_students": null, "greatschools_rating": null }, { "type": "Other", "address": "455 Arkansas Street, San Francisco, CA 94107", "school_name": "Bertrand D Hsu American & Chinese Bicultural Academy", "grades_served": "K-8", "distance_miles": 0.12, "greatschools_link": "https://www.greatschools.org/california/san-francisco/33953-Bertrand-D-Hsu-American--Chinese-Bicultural-Academy/", "number_of_students": null, "greatschools_rating": null }, { "type": "Public", "address": "465 Missouri Street, San Francisco, CA 94107", "school_name": "Daniel Webster Elementary School", "grades_served": "K-5", "distance_miles": 0.14, "greatschools_link": "https://www.greatschools.org/california/san-francisco/6451-Daniel-Webster-Elementary-School/", "number_of_students": 354, "greatschools_rating": 8 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"greatschools.org/search_schools","input":{"location":"94107"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find the top rated public elementary schools within 5 miles of ZIP code 78701, sorted by rating. - What schools are near 412 Maple Ave, Springfield, IL? I only want high schools and charter schools. - Show me private middle schools close to Portland, Oregon, closest first, up to 15 results. - On greatschools.org, list preschools within 5 miles of 60614 sorted by distance. - I'm relocating to Austin, TX and need a list of any-type schools near 30301 Peachtree area, ranked by GreatSchools rating, maximum 50. ## Input schema ```json { "type": "object", "required": [ "location" ], "properties": { "sort": { "enum": [ "distance", "rating" ], "type": "string", "default": "distance", "description": "Order results by proximity or GreatSchools rating, for example distance." }, "location": { "type": "string", "minLength": 2, "description": "US street address, city and state, or ZIP code, for example 94107." }, "grade_level": { "enum": [ "any", "preschool", "elementary", "middle", "high" ], "type": "string", "default": "any", "description": "Grade range to include, for example elementary." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum schools to return, for example 20." }, "school_type": { "enum": [ "any", "public", "charter", "private" ], "type": "string", "default": "any", "description": "Type of school to include, for example public." } } } ``` ## Output schema ```json { "type": "object", "required": [ "schools" ], "properties": { "schools": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": [ "string", "null" ] }, "address": { "type": [ "string", "null" ] }, "school_name": { "type": "string" }, "grades_served": { "type": [ "string", "null" ] }, "distance_miles": { "type": [ "number", "null" ] }, "greatschools_link": { "type": "string" }, "number_of_students": { "type": [ "integer", "null" ] }, "greatschools_rating": { "type": [ "integer", "null" ] } } } } } } ``` ## See more - [GreatSchools API: Get school rating and facts](https://fous.com/methods/greatschools.org/get-school.md): Finds a school on GreatSchools by name, city and state. Returns its ratings and key facts; anything the profile does not publish is null. - [Zillow API: Search homes for sale](https://fous.com/methods/zillow.com/search-homes.md): Searches Zillow homes for sale in a city and state, neighborhood or ZIP code, with optional price, bedroom, bathroom and property type filters and sort order, from Zillow's public search pages (up to 100 listings). - [Realtor.com API: Search agents by location](https://fous.com/methods/realtor.com/search-agents.md): Finds real estate agents working in a city and state or ZIP code on Realtor.com, in Realtor.com's relevance order, with ratings, sales figures, price range, languages and phone number when published. - [USGS API: Search earthquakes near a place](https://fous.com/methods/earthquake.usgs.gov/search-earthquakes.md): Finds recent USGS earthquakes near a city, address, or region, with distances and times in the searched place's time zone. - [McDonald's API: Search restaurants](https://fous.com/methods/mcdonalds.com/search-restaurants.md): Finds McDonald's restaurants within 50 miles of a US city, address or ZIP code, nearest first. Each result includes today's hours, services and directions. Open-now status follows the listed hours. - [AutoZone API: Search stores near a location](https://fous.com/methods/autozone.com/search-stores.md): Finds the AutoZone stores nearest a US ZIP code, city or street address, with contact details, opening hours, whether each is open now, distance and store page links. - [OfferUp API: Search listings](https://fous.com/methods/offerup.com/search-listings.md): Finds OfferUp items for sale near a US city or ZIP code, with prices, condition, seller names, distance and links. Distances use approximate listing locations. - [Postcodes.io API: List nearby postcodes](https://fous.com/methods/postcodes.io/list-nearby-postcodes.md): Lists UK postcodes nearest to a postcode or named place, with distance, ward, council and coordinates. For places sharing a name, a city or town is preferred. - [All GreatSchools methods](https://fous.com/methods/greatschools.org.md)