City Ventures APIcityventures.com ↗
Access City Ventures community listings and floor plan data across California. Get pricing, square footage, bed/bath counts, and QMI prices for all active developments.
What is the City Ventures API?
The City Ventures API provides 2 endpoints covering active new-home communities and their floor plans across California. The list_communities endpoint returns summary data for all developments—including starting price, square footage range, and bedroom/bathroom counts—while get_community_plans delivers per-plan detail such as QMI pricing and direct plan URLs for any given community slug.
curl -X GET 'https://api.parse.bot/scraper/989c377c-528b-4295-af3e-62558bcfdf9f/list_communities?market=socal' \ -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 cityventures-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: City Ventures New Homes SDK — browse communities and drill into floor plans."""
from parse_apis.City_Ventures_New_Homes_API import CityVentures, CommunityNotFound
client = CityVentures()
# List Southern California communities with summary details.
for community in client.communities.list(market="socal", limit=5):
print(community.name, community.city, community.starting_price)
# Drill into a single community to see its floor plans.
community = client.communities.list(limit=1).first()
if community:
for plan in community.plans.list(limit=5):
print(plan.plan_name, plan.square_footage, plan.starting_price, plan.listing_url)
# Construct a community by slug and list its plans directly.
try:
concord = client.community(slug="ca/compton/compton-concord-court")
for plan in concord.plans.list(limit=3):
print(plan.plan_name, plan.bedrooms, plan.bathrooms, plan.starting_price)
except CommunityNotFound as exc:
print(f"Community not found: {exc.community_slug}")
print("exercised: communities.list / community.plans.list / community() constructor / CommunityNotFound")
Lists all active City Ventures communities in California with summary details including name, city, price range, square footage range, and bedroom/bathroom counts. Optionally filtered by market region. Returns all communities in a single page.
| Param | Type | Description |
|---|---|---|
| market | string | Filter by market region. Accepted values: 'norcal' (Northern California), 'socal' (Southern California), or a city name (e.g. 'Santa Rosa'). Omitting returns all communities. |
{
"type": "object",
"fields": {
"total": "integer count of communities returned",
"communities": "array of community summary objects with name, city, slug, community_url, starting_price, square_footage, bedrooms, bathrooms"
},
"sample": {
"data": {
"total": 8,
"communities": [
{
"city": "Compton",
"name": "Concord Court",
"slug": "ca/compton/compton-concord-court",
"bedrooms": "3 - 4",
"bathrooms": "2.5 - 4",
"community_url": "https://cityventures.com/new-homes/ca/compton/compton-concord-court/",
"square_footage": "1,440 - 1,690",
"starting_price": "$609,990"
},
{
"city": "Artesia",
"name": "Eginhouse",
"slug": "ca/artesia/eginhouse",
"bedrooms": "3 - 4",
"bathrooms": "2.5 - 3",
"community_url": "https://cityventures.com/new-homes/ca/artesia/eginhouse/",
"square_footage": "2,000 - 2,000",
"starting_price": "$879,990"
}
]
},
"status": "success"
}
}About the City Ventures API
Community Listings
The list_communities endpoint returns all active City Ventures communities in a single response. Each community object includes name, city, slug, community_url, starting_price, square_footage, bedrooms, and bathrooms. The optional market parameter filters results to either norcal (Northern California) or socal (Southern California), useful when your application targets buyers in a specific region. The total field gives an integer count of matched communities.
Floor Plan Detail
The get_community_plans endpoint accepts a community_slug string—such as ca/compton/compton-concord-court—obtained from the slug field returned by list_communities. It returns a plans array where each object includes plan_name, square_footage, bedrooms, bathrooms, qmi_price (null when unavailable), starting_price, and a direct URL to the plan detail page. The response also surfaces top-level fields: builder_name (always City Ventures), community_name, community_url, and total_plans.
Data Coverage
All communities covered are California-based City Ventures developments. QMI (Quick Move-In) prices are returned when available at the plan level, and null otherwise, so callers should handle both cases. There is no pagination—both endpoints return complete result sets in a single response.
The City Ventures API is a managed, monitored endpoint for cityventures.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cityventures.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 cityventures.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?+
- Display a browsable map of all active City Ventures communities filtered by NorCal or SoCal region
- Compare starting prices across communities to surface the most affordable California new-home options
- Build a floor plan comparison tool showing square footage, bed/bath counts, and QMI prices side by side
- Alert buyers when a QMI (Quick Move-In) unit becomes available for a specific community
- Populate a property search widget with bedroom and bathroom filters drawn from real plan data
- Track changes in starting prices across communities over time for market trend analysis
| 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 City Ventures offer an official developer API?+
What does the `market` parameter in `list_communities` actually filter?+
norcal) or Southern California (socal). Omitting the parameter returns all active communities across both regions in one response.Does the API return availability counts, lot status, or individual unit inventory?+
How should I handle a null `qmi_price` in plan results?+
qmi_price means no Quick Move-In unit is currently listed for that plan. The starting_price field is always populated and represents the from-price for that floor plan. Callers should branch on null before displaying QMI pricing.