mhvillage.com APImhvillage.com ↗
Access MHVillage data via API: search mobile home parks by state/city, browse home listings, floor plans, and dealer info across the US.
curl -X GET 'https://api.parse.bot/scraper/cd1546be-5ca0-46b8-b9a5-2ba3aed3d4e0/list_parks_by_state?state_code=fl' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all mobile home parks/communities in a given US state, grouped by city. Each entry includes the city name, state, and count of parks in that city.
| Param | Type | Description |
|---|---|---|
| state_coderequired | string | 2-letter US state code, lowercase (e.g., 'fl', 'tx', 'ca'). |
{
"type": "object",
"fields": {
"total": "integer total number of cities with parks in the state",
"payload": "array of objects with locationName, locationType, parkCount, locationState, showcasedParkCount"
},
"sample": {
"data": {
"total": 426,
"status": 1,
"payload": [
{
"parkCount": 3,
"locationName": "Alachua",
"locationType": "city",
"locationState": "FL",
"showcasedParkCount": 0
}
]
},
"status": "success"
}
}About the mhvillage.com API
The MHVillage API provides 12 endpoints covering mobile home parks, home listings, floor plans, and dealer directories across the continental United States. You can query parks by state or city using list_parks_by_state and list_parks_by_city, search active for-sale and for-rent home listings with price and bedroom filters, retrieve floor plan specs including square footage and manufacturer, and pull dealer profiles with membership and contact details.
Park Discovery and Search
The API exposes three main paths for finding mobile home parks. list_states_with_parks returns the 48 continental US state codes that have park coverage, which is useful for building state-picker UIs or validating inputs. list_parks_by_state takes a lowercase two-letter state_code and returns city-level park counts — each object includes locationName, parkCount, and showcasedParkCount. list_parks_by_city and search_parks go deeper: both return park objects with key, name, ageRestrictions, petsAllowed, yearBuilt, website, and isShowcase. search_parks additionally accepts zip, radius (miles), has_pool, and park_type filters, making it the right choice for proximity-based or amenity-filtered lookups. Use get_park_detail with a park key to retrieve the full record including address, photos, phone, reviews, and site count.
Home Listings and Floor Plans
search_homes accepts city, zip, radius, min_price, max_price, and bedrooms filters and returns listing objects with askingPrice, bedrooms, bathrooms, year, make, model, isSale, and isRent flags. get_home_detail expands any listing by its key, adding photos, address, and park association. To scope listings to a specific community, get_park_homes accepts a park_id and returns the same listing shape with pagination via offset and limit.
Floor plan data is accessible through search_floor_plans (requires state_code) and get_floor_plan_detail. Response fields include bedrooms, bathrooms, squareFeet, manufacturer, modelName, dimension, and a virtualTour flag indicating whether a virtual tour is available for that plan.
Dealer Directory
search_dealers filters by state_code and city, returning dealer objects with key, name, caption, packageName, memberSince, and website. get_dealer_detail fetches a full dealer record and adds businessHoursDescription to that set. The memberSince field is useful for sorting or filtering by how long a dealer has been on the platform.
- Build a map-based park finder that filters results by state, pet policy, and pool availability using search_parks.
- Aggregate manufactured home listings by price range and bedroom count for a real estate comparison tool using search_homes.
- Display all active home listings within a specific community by calling get_park_homes with a park_id.
- Populate a dealer directory with contact details, business hours, and membership tenure from get_dealer_detail.
- Generate state-level market reports by pulling city-grouped park counts from list_parks_by_state.
- Allow users to browse floor plans by state, filtering by square footage or bedroom count via search_floor_plans.
- Cross-reference park age restrictions and pet policies to match buyer preferences when presenting get_park_detail results.
| 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.