niche.com APIniche.com ↗
Access K-12 school and college data from Niche.com: rankings, report card grades, stats, reviews, and autocomplete search across 5 endpoints.
curl -X GET 'https://api.parse.bot/scraper/1699b6f4-00c8-4d10-ba20-7829ae6046ef/search_k12_schools?page=1&type=private' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for K-12 schools with optional filters. Returns paginated results of schools ranked by Niche grade.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| type | string | School type filter. Accepted values: 'private', 'public', 'charter'. |
| grades | string | Grade level filter. Accepted values: 'elementary', 'middle', 'high'. |
{
"type": "object",
"fields": {
"page": "integer indicating current page number",
"schools": "array of school objects with name, slug, url, overall_grade, and tagline"
},
"sample": {
"data": {
"page": 1,
"schools": [
{
"url": "https://www.niche.com/k12/the-hotchkiss-school-lakeville-ct/",
"name": "The Hotchkiss School",
"slug": "the-hotchkiss-school-lakeville-ct",
"tagline": "",
"overall_grade": "A+"
}
]
},
"status": "success"
}
}About the niche.com API
The Niche.com API exposes 5 endpoints covering K-12 schools and colleges, including ranked search results, detailed report card grades, and paginated user reviews. The get_k12_school_overview endpoint alone returns over 7 distinct data categories — rankings, stats, tags, contact info, and more — for any school identified by its slug. College search and an autocomplete endpoint round out coverage for building school discovery and comparison tools.
K-12 School Search and Detail
The search_k12_schools endpoint returns paginated school lists filterable by type (private, public, charter) and grades (elementary, middle, high). Each result includes the school's name, slug, url, overall_grade, and tagline. The slug field is the key input for the two detail endpoints. get_k12_school_overview returns the full profile: a report_card array of graded categories with letter grades and numeric values, a rankings array with ordinal, total, and vanityURL per ranking list, a stats object with category-keyed stat arrays, and a contact object containing address, phone, and website.
Reviews and Ratings
get_k12_school_reviews accepts a slug and optional page parameter and returns a paginated reviews array. Each review object includes author, body, rating, date, and author_type — distinguishing, for example, parent reviews from student reviews. This makes it possible to segment sentiment by reviewer relationship to the school.
College Search and Autocomplete
search_colleges returns paginated college results ranked by Niche grade, with the same name, slug, url, overall_grade, and tagline shape as the K-12 search. The autocomplete_search endpoint accepts a free-text query and returns matched entities of mixed types (schools, districts, places) with guid, type, label, grade, state, url, and urlFragment fields — useful for building typeahead search UIs or resolving a user's school name input to a slug before fetching detail data.
- Build a school comparison tool using report_card grades and rankings from get_k12_school_overview
- Aggregate parent and student sentiment by filtering get_k12_school_reviews by author_type
- Power a school-finder typeahead using autocomplete_search with live query strings
- Filter and rank public vs. private vs. charter schools in a given search using the type parameter in search_k12_schools
- Display Niche ranking context (ordinal, total, vanityURL) alongside school profiles in a real estate or neighborhood app
- Collect stats and contact data for a directory of K-12 schools in a specific grades tier
- Enrich college application tools with Niche overall_grade and tagline data from search_colleges
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.