Olson Homes APIolsonhomes.com ↗
Access Olson Homes community listings, floor plan details, pricing, availability, and homesite status for new construction homes in Southern California.
What is the Olson Homes API?
The Olson Homes API provides 2 endpoints covering new construction community discovery and detailed homesite listings across Southern California. The get_community_listings endpoint returns per-homesite data including plan name, square footage, bedroom and bathroom counts, QMI price, starting 'from' price, move-in date, and current availability status — giving developers structured access to Olson Homes inventory without manual browsing.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/35c7c7ce-446f-4c88-91f7-48e3ce77813c/list_communities' \ -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 olsonhomes-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: Olson Homes SDK — browse communities, drill into listings."""
from parse_apis.Olson_Homes_API import OlsonHomes, CommunityNotFound
client = OlsonHomes()
# List all communities — limit caps total items fetched.
for community in client.communities.list(limit=5):
print(community.name, community.city)
# Drill into one community's listings via constructible resource.
descanso = client.community(slug="descanso-walk")
for listing in descanso.listings(limit=3):
print(listing.plan_name, listing.square_footage, listing.qmi_price, listing.status)
# Typed error handling for a non-existent community.
try:
bad = client.community(slug="nonexistent-community")
for item in bad.listings(limit=1):
print(item.plan_name)
except CommunityNotFound as exc:
print(f"Community not found: {exc.community_slug}")
print("exercised: communities.list / community.listings / CommunityNotFound")
List all Olson Homes communities currently shown on the website. Returns community names, URL slugs, and cities. Use the slug to query community listings via get_community_listings.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer",
"communities": "array of community objects with name, slug, url, and city"
},
"sample": {
"data": {
"total": 7,
"communities": [
{
"url": "https://www.olsonhomes.com/descanso-walk/",
"city": "Claremont",
"name": "Descanso Walk",
"slug": "descanso-walk"
},
{
"url": "https://www.olsonhomes.com/figtree-walk/",
"city": "Glendora",
"name": "Figtree Walk",
"slug": "figtree-walk"
},
{
"url": "https://www.olsonhomes.com/heritage-walk/",
"city": "Glendora",
"name": "Heritage Walk",
"slug": "heritage-walk"
}
]
},
"status": "success"
}
}About the Olson Homes API
Endpoints Overview
The API exposes two endpoints. list_communities returns a full index of active Olson Homes communities, including each community's name, slug, url, and city. The slug field is the key input for the second endpoint, allowing you to traverse from a community index to detailed listings in two calls.
Community Listings Detail
get_community_listings accepts a required community_slug string (e.g. 'descanso-walk' or 'tesoro-walk') and returns a listings array alongside community-level fields: from_price, community_name, community_slug, and total_listings. Each listing object includes builder_name, community_name, plan_name, sqft, bedrooms, bathrooms, qmi_price, from_price, status, move_in_date, and a direct listing_url. The status field indicates current availability, and qmi_price distinguishes quick move-in units from standard presale inventory.
Coverage and Scope
All communities listed are Olson Homes properties in Southern California. The list_communities endpoint requires no parameters and reflects the current community lineup shown on the site. Community slugs are stable enough to use as keys, but should be refreshed periodically via list_communities as new communities are added or retired. The from_price at the community level provides a quick filter signal; per-homesite qmi_price values reflect actual unit pricing where applicable.
The Olson Homes API is a managed, monitored endpoint for olsonhomes.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when olsonhomes.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 olsonhomes.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?+
- Monitor new homesite availability and status changes across all Olson Homes communities.
- Aggregate starting prices by city using
from_priceandcityfields from both endpoints. - Filter quick move-in (QMI) units by checking
qmi_pricefor non-null values across listings. - Build a floor plan comparison tool using
sqft,bedrooms,bathrooms, andplan_namefields. - Track move-in date timelines across communities to surface near-term availability.
- Index all community URLs from
list_communitiesfor SEO monitoring or competitive research. - Alert prospective buyers when a specific community's
total_listingscount changes orstatusupdates.
| 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 Olson Homes have an official developer API?+
What does the `status` field in get_community_listings represent?+
status field reflects the current availability state of a specific homesite as shown on the Olson Homes site — for example, whether a unit is available, sold, or under contract. The qmi_price field specifically identifies quick move-in units, which are priced and available for near-term occupancy, distinct from homes still in a presale or build phase.