homesbywelkin.com APIwww.homesbywelkin.com ↗
Access Welkin Homes floor plan listings and community data via API. Retrieve plan details, pricing, bed/bath counts, and square footage for Southern California developments.
curl -X GET 'https://api.parse.bot/scraper/19f01856-0830-406f-ac39-aef7eb441ec4/get_community_plans?community_slug=welkin-223' \ -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 homesbywelkin-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: Welkin Homes SDK — browse communities and floor plans."""
from parse_apis.Welkin_Homes_API import WelkinHomes, CommunityNotFound
client = WelkinHomes()
# List all communities (active, coming soon, completed)
for community in client.communities.list(limit=5):
print(community.name, community.status, community.square_footage)
# Drill into the first community's floor plans
community = client.communities.list(limit=1).first()
if community:
for plan in community.plans.list(limit=5):
print(plan.plan_name, plan.bedrooms, plan.bathrooms, plan.starting_price)
# Handle a missing community gracefully
try:
for plan in community.plans.list(limit=3):
print(plan.builder_name, plan.listing_url)
except CommunityNotFound as exc:
print(f"Community not found: {exc}")
print("exercised: communities.list / plans.list / CommunityNotFound")
Retrieve floor plan listings for a specific Welkin Homes community page. Returns builder name, community name, plan name, square footage, bedrooms, bathrooms, QMI price, starting price, and listing URL for each plan. Data is extracted from the community's WordPress page content.
| Param | Type | Description |
|---|---|---|
| community_slug | string | URL slug of the community page. Known values: welkin-223 (active community), coming-soon-v2 (upcoming projects), projects (completed projects). |
{
"type": "object",
"fields": {
"url": "string",
"plans": "array of plan objects with builder_name, community_name, plan_name, square_footage, bedrooms, bathrooms, qmi_price, starting_price, listing_url",
"community": "string"
},
"sample": {
"data": {
"url": "https://www.homesbywelkin.com/welkin-223/",
"plans": [
{
"bedrooms": "3 + loft",
"bathrooms": "2.5",
"plan_name": "Plan-A",
"qmi_price": null,
"listing_url": "https://www.homesbywelkin.com/welkin-223/",
"builder_name": "Welkin Homes",
"community_name": "Welkin 223",
"square_footage": "1,924-1,984",
"starting_price": "From the mid-$900k"
},
{
"bedrooms": "4",
"bathrooms": "3.5",
"plan_name": "Plan-B",
"qmi_price": null,
"listing_url": "https://www.homesbywelkin.com/welkin-223/",
"builder_name": "Welkin Homes",
"community_name": "Welkin 223",
"square_footage": "2,283-2,352",
"starting_price": "From the mid-$900k"
}
],
"community": "Welkin 223"
},
"status": "success"
}
}About the homesbywelkin.com API
The Welkin Homes API provides 2 endpoints for querying floor plan listings and community data from homesbywelkin.com. The get_community_plans endpoint returns per-plan details including square footage, bedroom and bathroom counts, QMI price, and starting price for a given community. The list_communities endpoint surfaces all Welkin developments across active, coming-soon, and completed statuses.
Community Listings
The list_communities endpoint requires no input parameters and returns an array of all Welkin Homes communities. Each community object includes name, location, status (active, coming soon, or completed), bedrooms, square_footage, starting_price, and url. This gives a complete picture of Welkin's current and historical Southern California development portfolio without needing to query individual pages.
Floor Plan Details
The get_community_plans endpoint accepts a community_slug string parameter to target a specific community page. Known slugs include welkin-223 for the active selling community and coming-soon-v2 for upcoming projects. The response includes the community name, source url, and a plans array. Each plan object carries builder_name, community_name, plan_name, square_footage, bedrooms, bathrooms, qmi_price (quick move-in pricing), and starting_price.
Coverage Notes
All data reflects Welkin Homes' Southern California portfolio. Pricing fields (qmi_price, starting_price) are present where Welkin publishes them for a given plan; some plans or coming-soon communities may return null for price fields. The status field in list_communities distinguishes between homes currently for sale, projects not yet open, and completed builds.
The homesbywelkin.com API is a managed, monitored endpoint for www.homesbywelkin.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when www.homesbywelkin.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 www.homesbywelkin.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?+
- Aggregate new-construction floor plan pricing across Southern California homebuilders for market comparison.
- Track when a Welkin coming-soon community transitions to active-selling status by polling
list_communities. - Build a filtered search tool that surfaces Welkin plans by minimum square footage or bedroom count.
- Monitor QMI (quick move-in) price changes on available plans using
get_community_plans. - Populate a real estate research dashboard with new-construction starting prices alongside resale comps.
- Generate alerts when new communities appear in the
list_communitiesresponse that weren't present previously.
| 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 Welkin Homes provide an official developer API?+
What does `get_community_plans` return for pricing, and what is QMI price?+
starting_price (the base price for that floor plan) and qmi_price (quick move-in price, applicable when a specific already-built home is available for immediate purchase). Either field may be null if Welkin has not published pricing for that plan.Are individual home listings with addresses or lot numbers available?+
What community slugs can be passed to `get_community_plans`?+
welkin-223 for the current active community and coming-soon-v2 for upcoming projects. Other slugs may work if Welkin adds new community pages, but only these two are confirmed. The list_communities endpoint returns url fields for each community, which can help identify additional slugs.Does the API cover Welkin Homes communities outside Southern California?+
list_communities response once published on their site.