Risewell Homes APIrisewellhomes.com ↗
Access Risewell Homes community listings, floor plans, and QMI homes via API. Returns pricing, sqft, bedrooms, bathrooms, and community slugs.
What is the Risewell Homes API?
The Risewell Homes API provides 2 endpoints to query new home communities, floor plans, and Quick Move-In (QMI) homes from the Risewell Homes builder catalog. The list_communities endpoint returns division, status, price ranges, and slugs for every active community, while get_community_plans delivers per-community floor plan and QMI detail including bedroom count, square footage, starting prices, and individual listing URLs.
curl -X GET 'https://api.parse.bot/scraper/cf2a3ea3-6712-4faa-bd60-3afd87ca9320/get_community_plans?community_slug=gage' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace risewellhomes-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Risewell Homes SDK — browse communities, drill into plans and QMI homes."""
from parse_apis.Risewell_Homes_API import RisewellHomes, CommunityNotFound
client = RisewellHomes()
# List communities, capped to 5
for community in client.communities.list(limit=5):
print(community.name, community.division, community.status)
# Drill into a specific community's floor plans
gage = client.community(slug="gage")
for plan in gage.plans.list(limit=3):
print(plan.plan_name, plan.square_footage, plan.starting_price, plan.incentive)
# Check QMI (quick move-in) homes for same community
for home in gage.qmi_homes.list(limit=3):
print(home.plan_name, home.qmi_price, home.address, home.incentive)
# Typed error handling: attempt to fetch a non-existent community
try:
bad = client.community(slug="nonexistent-community-xyz")
for plan in bad.plans.list(limit=1):
print(plan.plan_name)
except CommunityNotFound as exc:
print(f"Community not found: {exc.community_slug}")
print("exercised: communities.list / community.plans.list / community.qmi_homes.list / CommunityNotFound")
Retrieve all floor plans and Quick Move-In homes for a specific community. Returns builder name, community name, plan names, square footage, bedrooms, bathrooms, pricing, status, listing URLs, and current promotional incentive. Each community contains both floor plans (with starting 'from' prices) and QMI homes (with current sale prices, addresses, and move-in dates).
| Param | Type | Description |
|---|---|---|
| community_slugrequired | string | URL slug identifying the community (e.g. 'gage', 'brickline', 'valor-at-liberty'). Obtain from list_communities endpoint. |
{
"type": "object",
"fields": {
"incentive": "string or null, current promotional offer for the community",
"qmi_homes": "array of QMI home objects",
"floor_plans": "array of floor plan objects",
"builder_name": "string",
"community_url": "string",
"community_name": "string",
"total_qmi_homes": "integer",
"total_floor_plans": "integer"
},
"sample": {
"data": {
"qmi_homes": [
{
"city": "Huntington Beach",
"state": "CA",
"garage": 2,
"status": "Move-In Ready",
"address": "7256 Aura Circle",
"bedrooms": 2,
"homesite": "29",
"bathrooms": 2.5,
"plan_name": "Plan Two",
"qmi_price": 969990,
"listing_url": "https://risewellhomes.com/southern-california/orange-county-new-homes/neighborhoods/gage/lot-29-plan-two/",
"plan_number": null,
"postal_code": "92647",
"builder_name": "Risewell Homes",
"listing_type": "qmi",
"community_name": "Gage",
"square_footage": 1266,
"starting_price": null,
"completion_date": "2025-12-01T00:00:00+00:00"
}
],
"floor_plans": [
{
"garage": 2,
"status": "Now Selling",
"bedrooms": 3,
"bathrooms": 2.5,
"plan_name": "Plan Three",
"qmi_price": null,
"listing_url": "https://risewellhomes.com/southern-california/orange-county-new-homes/neighborhoods/gage/plan-three-3/",
"plan_number": null,
"bedrooms_max": 3,
"builder_name": "Risewell Homes",
"listing_type": "floor_plan",
"bathrooms_max": 2.5,
"community_name": "Gage",
"square_footage": 1389,
"starting_price": 1124050,
"square_footage_max": 1389
}
],
"builder_name": "Risewell Homes",
"community_url": "https://risewellhomes.com/southern-california/orange-county-new-homes/neighborhoods/gage/",
"community_name": "Gage",
"total_qmi_homes": 1,
"total_floor_plans": 6
},
"status": "success"
}
}About the Risewell Homes API
Community Discovery
The list_communities endpoint returns a flat array of community objects, each including the community name, slug, url, division, status, and price/sqft ranges. The optional region parameter accepts a keyword string (e.g. 'california' or 'gage') to narrow results. The optional limit parameter caps how many communities are returned. The total field in the response reflects the unfiltered count before any limit is applied. Slugs returned here are the required input for the second endpoint.
Floor Plans and QMI Homes
Passing a community_slug to get_community_plans returns two distinct arrays: floor_plans and qmi_homes. Floor plan objects include plan name, square footage, bedroom and bathroom counts, and a starting from price. QMI (Quick Move-In) home objects represent specific inventory homes that are immediately available, each with its own pricing, status, and listing URL. The response also surfaces builder_name, community_name, community_url, total_floor_plans, and total_qmi_homes as top-level fields, giving you a full picture of availability without additional calls.
Workflow
The intended pattern is sequential: call list_communities first to retrieve slugs, then call get_community_plans with a specific slug to get detailed plan and inventory data. There is no single endpoint that returns all communities with full plan details in one call.
The Risewell Homes API is a managed, monitored endpoint for risewellhomes.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when risewellhomes.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official risewellhomes.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track starting prices and square footage across Risewell floor plans to compare value across communities.
- Monitor QMI home inventory counts by community to identify where immediate-availability homes exist.
- Build a new-construction property search tool filtered by bedroom count using floor plan data.
- Aggregate community status and division metadata to map Risewell's geographic footprint.
- Alert prospective buyers when new QMI homes appear in a target community slug.
- Compare price-per-sqft ranges across communities using data returned by list_communities.
| 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 | 100 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.
Does Risewell Homes offer an official developer API?+
What distinguishes floor plan objects from QMI home objects in get_community_plans?+
from price reflecting the base cost for that plan type. QMI homes are specific, already-built or near-complete homes with their own individual pricing, status, and a direct listing URL. A community can have multiple QMI homes based on the same floor plan, each priced independently.Does the API cover communities outside Southern California or beyond Risewell's current active listings?+
Can I retrieve detailed lot-level data, site maps, or neighborhood amenity information?+
How do I find the right community_slug to pass to get_community_plans?+
list_communities first. Each community object in the response includes a slug field (e.g. 'gage', 'brickline'). Pass that slug as the community_slug parameter in get_community_plans. The region parameter on list_communities can help narrow the result set if you know part of the community name.