Homes.com School API returns one school: type, level, grades, district, address, key statistics, ratings with their sub scores, programs, photos and homes for sale nearby. Get the school id from the listing route (schools[].school_id) or from autocomplete with type=school. An unknown id returns 404 and is not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
School id. Example: tvy63b8lylm0g.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"url": "https://www.homes.com/school/austin-tx/jollyville-elementary-school/tvy63b8lylm0g/",
"name": "Jollyville Elementary School",
"type": "Public",
"level": "Pre-K, Elementary",
"stats": [
{
"name": "Students",
"value": "471"
},
{
"name": "Niche Grade",
"value": "A-"
}
],
"grades": "Pre-K-5",
"photos": [
{
"url": "https://imagescdn.homes.com/i2/QZxFLdnjcMMC7nfa_QJhbJ9F5zdR3TycAsrmqPxbO-Y/111/jollyville-elementary-school-austin-tx-primaryphoto.jpg?p=1",
"width": 8064,
"height": 5376,
"caption": null
},
{
"url": "https://imagescdn.homes.com/i2/CX1jW3OWnJbfcZQRdkZCImWdI_d-nmIfYSBTEg84OKk/111/jollyville-elementary-school-austin-tx-2-schoolphoto.jpg?p=1",
"width": 5464,
"height": 3640,
"caption": null
}
],
"address": {
"street": "6720 Corpus Christi Dr",
"city_state": "Austin, TX",
"coordinates": {
"latitude": 30.444,
"longitude": -97.751
}
},
"ratings": {
"niche": [
{
"name": "Academics",
"value": "A-"
},
{
"name": "Teachers",
"value": "C+"
}
],
"niche_grade": "A-",
"greatschools": [
{
"name": "Test Scores",
"value": "8"
},
{
"name": "Equity",
"value": "4"
}
],
"greatschools_rating": "8"
},
"district": "Round Rock Independent School District",
"programs": [
"Free/Reduced Lunch Offered"
],
"school_id": "tvy63b8lylm0g",
"highlights": [
{
"name": "Head of School",
"value": "Scott C Morgan"
},
{
"name": "Student Teacher Ratio",
"value": "14:1"
}
],
"grade_sections": [
{
"name": "Academics",
"rows": [
{
"name": "Reading Proficiency",
"value": "65%"
},
{
"name": "Math Proficiency",
"value": "61%"
}
],
"value": "A-"
},
{
"name": "Teachers",
"rows": [
{
"name": "Student Teacher Ratio",
"value": "14:1"
},
{
"name": "Full Time Teachers",
"value": "46"
}
],
"value": "C+"
}
],
"homes_for_sale": {
"items": [
{
"id": "cctfc9pfg6ydv",
"url": "https://www.homes.com/property/6700-shiner-st-austin-tx/cctfc9pfg6ydv/",
"beds": 4,
"sqft": 2419,
"agent": {
"name": "Adam Baker",
"phone": "(512) 777-1524",
"agency": "Serhant Texas, LLC",
"agent_id": "nvpy3cq",
"photo_url": "https://imagescdn.homes.com/i2/a1H9wREpJ5QiAmzdeCyHOnWomiL6rg0vNwBZKDYlaPQ/105/image.jpg?t=p&p=1",
"agency_logo_url": "https://imagescdn.homes.com/i2/HQr3l-C0AavIOOeGS_QEt-7Qg32wBmxoNXRXVtFQyO4/105/image.png?t=p&p=1"
},
"baths": 2.5,
"price": {
"label": "$495,000",
"value": 495000,
"currency": "USD"
},
"badges": [
"$5K PRICE DROP"
],
"photos": [
{
"url": "https://images.homes.com/listings/111/2188306215-035165632/6700-shiner-st-austin-tx-primaryphoto.jpg",
"width": 1535,
"height": 1025,
"caption": "Welcome to 6700 Shiner St!"
},
{
"url": "https://images.homes.com/listings/111/6088306215-035165632/6700-shiner-st-austin-tx-buildingphoto-2.jpg",
"width": 1536,
"height": 1024,
"caption": "Living room with high ceilings, fireplace and large windows *virtually staged*"
}
],
"status": "active",
"address": {
"city": "Austin",
"full": "6700 Shiner St, Austin, TX 78729",
"unit": null,
"state": "TX",
"street": "6700 Shiner St",
"building": null,
"coordinates": {
"latitude": 30.447674,
"longitude": -97.7465
},
"postal_code": "78729"
},
"builder": null,
"beds_max": 4,
"beds_min": 4,
"lot_sqft": 6738,
"rent_max": null,
"rent_min": null,
"sqft_max": 2419,
"sqft_min": 2419,
"baths_max": 2,
"baths_min": 2,
"community": null,
"list_date": "2026-09-18T00:00:00+00:00",
"lot_acres": 0.15,
"photo_url": "https://images.homes.com/listings/111/2188306215-035165632/6700-shiner-st-austin-tx-primaryphoto.jpg",
"sold_date": null,
"beds_label": "4 Beds",
"highlights": [],
"listing_id": "76y93sfkgy75p",
"year_built": 1985,
"baths_label": "2.5 Baths",
"description": "Freshly updated and move-in ready, this 4-bedroom home features fresh interior paint, new fixtures throughout, new carpet upstairs, and a new roof with Class 4 impact-resistant ...",
"open_houses": [],
"units_count": null,
"listing_type": "sale",
"property_type": {
"code": 1,
"slug": "house",
"label": "House"
},
"days_on_market": null,
"original_price": {
"label": null,
"value": 500000,
"currency": "USD"
},
"price_per_sqft": 205,
"property_manager": null,
"available_units_count": null
},
{
"id": "zrslg7w7lwvtp",
"url": "https://www.homes.com/property/7017-tesoro-trail-austin-tx/zrslg7w7lwvtp/",
"beds": 3,
"sqft": 1618,
"agent": {
"name": "Laurie Flood",
"phone": "(512) 576-6439",
"agency": "Keller Williams Realty",
"agent_id": "6ksjr2r",
"photo_url": "https://imagescdn.homes.com/i2/k3LUeyskM-Q9j-6yMa_1owarM5vKFsynX20R3mtPYVM/105/image.jpg?t=p&p=1",
"agency_logo_url": "https://images.homes.com/brands/105/9743_aspect.png?t=p"
},
"baths": 2,
"price": {
"label": "$419,900",
"value": 419900,
"currency": "USD"
},
"badges": [
"$5K PRICE DROP"
],
"photos": [
{
"url": "https://images.homes.com/listings/111/3197926715-136938432/7017-tesoro-trail-austin-tx-primaryphoto.jpg",
"width": 2048,
"height": 1364,
"caption": null
},
{
"url": "https://images.homes.com/listings/111/5085602015-136938432/7017-tesoro-trail-austin-tx-buildingphoto-2.jpg",
"width": 2048,
"height": 1364,
"caption": null
}
],
"status": "active",
"address": {
"city": "Austin",
"full": "7017 Tesoro Trail, Austin, TX 78729",
"unit": null,
"state": "TX",
"street": "7017 Tesoro Trail",
"building": null,
"coordinates": {
"latitude": 30.445382,
"longitude": -97.752839
},
"postal_code": "78729"
},
"builder": null,
"beds_max": 3,
"beds_min": 3,
"lot_sqft": 6494,
"rent_max": null,
"rent_min": null,
"sqft_max": 1618,
"sqft_min": 1618,
"baths_max": 2,
"baths_min": 2,
"community": null,
"list_date": "2026-07-22T00:00:00+00:00",
"lot_acres": 0.14,
"photo_url": "https://images.homes.com/listings/111/3197926715-136938432/7017-tesoro-trail-austin-tx-primaryphoto.jpg",
"sold_date": null,
"beds_label": "3 Beds",
"highlights": [],
"listing_id": "14w9nq3fzfp1v",
"year_built": 1986,
"baths_label": "2 Baths",
"description": "****This property qualifies for 1% loan credit- inquire for details!*** Beautiful move-in-ready home in an incredible NW Austin location with roof just replaced in July 2026 and...",
"open_houses": [],
"units_count": null,
"listing_type": "sale",
"property_type": {
"code": 1,
"slug": "house",
"label": "House"
},
"days_on_market": null,
"original_price": {
"label": null,
"value": 425000,
"currency": "USD"
},
"price_per_sqft": 260,
"property_manager": null,
"available_units_count": null
}
],
"total": 16
}
},
"meta": {
"billable": true,
"endpoint_family": "school"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a range is invalid, or the page is beyond the first 700 results. This response is not billable.
{
"errors": {
"query": [
"The query field is required."
]
},
"message": "The request validation failed"
}Not Found
The school does not exist. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "school"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Upstream Unavailable
Homes.com could not be reached or returned data that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "school"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Homes.com could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.