# Homes.com School API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/homes-com-api/homes_com_school](https://scrappa.co/docs/homes-com-api/homes_com_school) - **API group:** Homes.com API - **Endpoint:** `GET https://scrappa.co/api/homes-com/school` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `id` | string | Yes | School id. Example: tvy63b8lylm0g. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A required parameter or a range is invalid, or the page is beyond the first 700 results. This response is not billable. | | 404 | Not Found | The school does not exist. This response is not billable. | | 503 | 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. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)