meliahomes.com APImeliahomes.com ↗
Access floor plan details and quick move-in home listings from Melia Homes communities in Southern California via a single structured API endpoint.
curl -X GET 'https://api.parse.bot/scraper/712dd070-a31e-4629-ba20-81a13e7dc484/get_community_plans?community_slug=indigo' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed Python client. Install the CLI, sign in, then pull this API’s generated client:
pip install parse-sdk parse login parse add --marketplace meliahomes-com-api
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: MeliaHomes SDK — list floor plans and QMI homes for a community."""
from parse_apis.Melia_Homes_API import MeliaHomes, CommunityNotFound
client = MeliaHomes()
# List all plans and QMI homes for the Indigo community in Hawthorne
community = client.community("indigo")
for listing in community.plans(limit=5):
print(listing.plan_name, listing.listing_type, listing.bedrooms, "beds", listing.square_footage, "sqft")
# Get the first QMI listing and inspect its price
first = community.plans(limit=1).first()
if first:
print(first.plan_name, first.qmi_price, first.listing_url)
# Handle a community that doesn't exist
try:
bad = client.community("nonexistent-place")
bad.plans(limit=1).first()
except CommunityNotFound as exc:
print(f"Community not found: {exc.community_slug}")
print("exercised: community.plans / listing attributes / CommunityNotFound error")
Retrieve all floor plans and quick move-in (QMI) homes for a specific Melia Homes community. Returns builder name, community name, plan names, square footage, bedrooms, bathrooms, QMI prices, community-level starting price, and listing URLs for each home or plan in the community. Communities that are sold out will return an empty listings array.
| Param | Type | Description |
|---|---|---|
| community_slugrequired | string | URL slug of the community (the last path segment of the community page URL). Known active communities: breckyn, cadence, cerise-at-citrus-square, elara, indigo, townes-at-orange. |
{
"type": "object",
"fields": {
"listings": "array of listing objects with plan details",
"total_count": "integer",
"builder_name": "string",
"community_url": "string",
"community_name": "string",
"starting_from_price": "string or null — community-level starting price range (e.g. 'the High $900,000’s')"
},
"sample": {
"data": {
"listings": [
{
"status": "Under Construction",
"bedrooms": "4",
"bathrooms": "3.5",
"plan_name": "12720 Azure Way Unit 27",
"qmi_price": "$974,900",
"listing_url": "https://meliahomes.com/new-homes/ca/hawthorne/indigo/plan-4-indigo/indigo/",
"builder_name": "Melia Homes",
"listing_type": "qmi",
"community_name": "Indigo",
"square_footage": "1946",
"starting_from_price": null
},
{
"status": null,
"bedrooms": "1",
"bathrooms": "1.5",
"plan_name": "Plan 1",
"qmi_price": null,
"listing_url": "https://meliahomes.com/new-homes/ca/hawthorne/indigo/plan-1-indigo/",
"builder_name": "Melia Homes",
"listing_type": "floor_plan",
"community_name": "Indigo",
"square_footage": "926",
"starting_from_price": "the High $900,000's"
}
],
"total_count": 6,
"builder_name": "Melia Homes",
"community_url": "https://meliahomes.com/new-homes/ca/hawthorne/indigo/",
"community_name": "Indigo",
"starting_from_price": "the High $900,000's"
},
"status": "success"
}
}About the meliahomes.com API
The Melia Homes API exposes floor plan and quick move-in (QMI) home data from Southern California new-home communities through 1 endpoint returning 8 distinct response fields. The get_community_plans endpoint accepts a community slug and returns plan names, square footage, bedroom and bathroom counts, QMI pricing, a community-level starting price, and direct listing URLs — all in a single structured response.
What the API Returns
The get_community_plans endpoint retrieves every floor plan and available QMI home associated with a Melia Homes community. Pass the community_slug parameter — the final path segment of a community's URL — and the response contains a listings array, a total_count, the builder_name, community_name, community_url, and a starting_from_price string (e.g. 'the High $900,000's') that reflects the community-level advertised price range.
Listing Object Fields
Each object inside the listings array carries plan-level detail: plan name, square footage, number of bedrooms, number of bathrooms, QMI price, and a direct URL to that specific home or plan page on meliahomes.com. This gives enough data to filter and compare plans programmatically without additional fetches.
Coverage and Known Communities
Coverage is scoped to Melia Homes communities in Southern California. The currently documented active slug is breckyn. The community_slug input is designed to accept any valid community path segment, so additional communities can be queried as they become available on meliahomes.com. The starting_from_price field may return null if no community-level price is published for the queried slug.
The meliahomes.com API is a managed, monitored endpoint for meliahomes.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when meliahomes.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 meliahomes.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 QMI price changes across Melia Homes communities by polling
get_community_planson a schedule - Build a floor plan comparison tool using square footage, bedroom, and bathroom fields from the listings array
- Aggregate new-home inventory from Southern California builders alongside data from other regional developers
- Alert buyers when new QMI homes become available in a specific community by tracking
total_countchanges - Populate a real estate search interface with direct listing URLs and plan details for Melia Homes properties
- Analyze price-per-square-foot trends for new construction in Southern California using QMI price and square footage fields
| 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.
Does Melia Homes offer an official developer API?+
What does `starting_from_price` represent and when is it null?+
starting_from_price field reflects the community-level advertised price range shown on the community page, such as 'the High $900,000's'. It returns null when Melia Homes has not published a starting price for that community. Individual QMI home prices are returned separately within each object in the listings array.Does the API cover multiple Melia Homes communities or just one?+
community_slug, and the currently documented active example is breckyn. Other community slugs taken from meliahomes.com URLs can be passed to the same endpoint. Coverage is limited to communities Melia Homes operates in Southern California.