Meritage Homes APImeritagehomes.com ↗
Search Meritage Homes listings and floor plans across US communities. Filter by state, metro, price, beds, sqft. Returns pricing, community, and plan details.
What is the Meritage Homes API?
The Meritage Homes API gives developers access to new construction home listings and floor plans across Meritage communities in the United States via 2 endpoints. The search_homes endpoint lets you filter inventory by state, metro area, price range, bedroom count, and square footage, while get_community_homes retrieves every available home and floor plan within a specific community using either a URL slug or a Salesforce community ID.
curl -X POST 'https://api.parse.bot/scraper/278b6c57-a198-41fc-9fa7-fe3dda0d75ad/get_community_homes' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"limit": "50",
"offset": "0",
"community_id": "a070h00000xoEFzAAM",
"community_slug": "state/ca/southern-ca/stratus"
}'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 meritagehomes-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: Meritage Homes SDK — search homes, drill into communities."""
from parse_apis.Meritage_Homes_API import MeritageHomes, CommunityNotFound
client = MeritageHomes()
# Search homes in Texas, capped at 5 results
for home in client.homes.search(state="TX", limit=5):
print(home.plan_name, home.community_name, f"${home.qmi_price}", home.square_footage, "sqft")
# Drill into a specific community by ID
community = client.community(community_id="a070h00000xoEFzAAM")
first_home = community.homes(limit=1).first()
if first_home:
print(first_home.plan_name, first_home.bedrooms, "bed", first_home.bathrooms_full, "bath")
print(first_home.listing_url)
# Handle a bad community slug gracefully
try:
bad_community = client.community(community_id="invalid_id_xyz")
list(bad_community.homes(limit=1))
except CommunityNotFound as exc:
print(f"Community not found: {exc}")
print("exercised: homes.search / community.homes / CommunityNotFound")
Get all available homes and floor plans for a specific Meritage Homes community. Accepts either a community URL slug or a Salesforce community ID. Returns homes with plan details, pricing, square footage, bedrooms, bathrooms, and listing URLs. The from_price is the lowest listed price across all homes in the community.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of homes to return. |
| offset | integer | Number of results to skip for pagination. |
| community_id | string | Salesforce community ID (e.g. 'a070h00000xoEFzAAM'). Either community_slug or community_id is required. |
| community_slug | string | URL path slug for the community page (e.g. 'state/ca/southern-ca/stratus'). Either community_slug or community_id is required. |
{
"type": "object",
"fields": {
"homes": "array of home objects with builder_name, community_name, plan_name, square_footage, bedrooms, bathrooms_full, bathrooms_half, qmi_price, from_price, listing_url, address, city, state, zipcode, status, stories, garages, description, snipe, image_url",
"limit": "integer current limit",
"total": "integer total number of matching homes",
"offset": "integer current offset",
"community_id": "string Salesforce community ID used for the query"
},
"sample": {
"data": {
"homes": [
{
"city": "Pomona",
"snipe": "Up to $25K Flex Cash + Solar",
"state": "CA",
"status": "Inventory",
"address": "1567 Stratus Drive",
"garages": 2,
"stories": 3,
"zipcode": "91768",
"bedrooms": 3,
"image_url": "https://mhc-p-001.sitecorecontenthub.cloud/api/public/content/2a4170dbe8984b0690730d84fb71ab5e?v=1798b3a8",
"plan_name": "Residence 2",
"qmi_price": 599000,
"from_price": 599000,
"description": "Feel the openness with spacious living areas, a downstairs bedroom and an outdoor deck. The primary suite offers privacy with a separated secondary bedroom. Stay organized with the walk-in laundry room, extra garage space, and dedicated storage room.",
"listing_url": "https://www.meritagehomes.com/state/ca/southern-ca/1567-stratus-drive",
"builder_name": "Meritage Homes",
"bathrooms_full": 3,
"bathrooms_half": 0,
"community_name": "Stratus",
"square_footage": 1497
}
],
"limit": 50,
"total": 2,
"offset": 0,
"community_id": "a070h00000xoEFzAAM"
},
"status": "success"
}
}About the Meritage Homes API
Endpoints and What They Return
The search_homes endpoint accepts optional filters including state (two-letter code), metro_area (e.g. 'Southern CA', 'Dallas/Ft. Worth'), min_price/max_price, min_sqft/max_sqft, and bedrooms. Results are paginated via limit and offset. Each home object in the returned homes array includes builder_name, community_name, plan_name, square_footage, bedrooms, bathrooms_full, bathrooms_half, qmi_ fields, and the listing URL. The response also carries total so you can calculate page counts.
The get_community_homes endpoint narrows the query to a single Meritage community. You identify the community with either a community_slug (e.g. 'state/ca/southern-ca/stratus') or a Salesforce community_id (e.g. 'a070h00000xoEFzAAM'). The response mirrors the structure of search_homes and also echoes back the resolved community_id, which is useful if you started from a slug and want to cache the canonical identifier. The from_price field represents the lowest listed price within that community.
Coverage and Filters
Meritage Homes builds in several US states including Texas, California, Arizona, Georgia, and Florida. The metro_area parameter maps to Meritage's own metro groupings, so values should match how the builder categorizes their markets (e.g. 'Phoenix', 'Houston', 'Atlanta'). Using an unrecognized metro string will return zero results rather than an error. Pagination applies to both endpoints via limit and offset, and the total field in every response tells you how many homes match the current filter set.
The Meritage Homes API is a managed, monitored endpoint for meritagehomes.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when meritagehomes.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 meritagehomes.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?+
- Build a new-construction home search tool filtered by state, metro area, and price range using
search_homes - Aggregate floor plan options for a specific community by
community_slugto display on a real estate comparison site - Track inventory changes in a given metro area by periodically querying
search_homeswith a fixedmetro_areafilter - Find all available homes within a square footage range using
min_sqftandmax_sqftfilters for buyer matching tools - Resolve a Meritage community page URL to its canonical Salesforce
community_idfor downstream CRM integrations - Power a bedroom-count and bathroom-count faceted filter UI backed by live Meritage inventory data
- Compare
from_priceacross multiple communities in the same metro to surface the most affordable new-build options
| 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 Meritage Homes offer an official public developer API?+
How do I look up homes in a specific metro area and what metros are supported?+
metro_area string to search_homes using Meritage's own naming conventions — for example 'Southern CA', 'Phoenix', 'Houston', 'Dallas/Ft. Worth', or 'Atlanta'. The parameter is optional; omitting it returns results across all available markets. Using a string that doesn't match a known Meritage metro will return an empty result set rather than an error.Does the API expose community-level details like amenities, lot maps, or location coordinates?+
Can I retrieve sold or closed homes, not just available inventory?+
What is the difference between using `community_slug` and `community_id` in `get_community_homes`?+
community_slug is the URL path (e.g. 'state/ca/southern-ca/stratus') while community_id is the Salesforce identifier (e.g. 'a070h00000xoEFzAAM'). Either one is accepted; only one is required. The response always echoes back the resolved community_id, so you can start from a human-readable slug and store the canonical ID for future requests.