Understanding "Plus" in numBedroomsPlus, numBathroomsPlus, numKitchensPlus, and numRoomsPlus
When working with our API, you may encounter fields such as numBedroomsPlus, numBathroomsPlus, numKitchensPlus, and numRoomsPlus. These fields are used to indicate additional rooms that were not part of the original design of the home. Instead, these rooms were added during a renovation or an extension of the property.
The "Plus" in these fields signifies rooms that have been added to the original layout of the home. For example:
numBedroomsPlus: Additional bedrooms added during renovations.
numBathroomsPlus: Additional bathrooms that were constructed after the home was originally built.
numKitchensPlus: Extra kitchens that were added, possibly as part of an in-law suite or basement apartment.
numRoomsPlus: Other types of rooms (such as offices, dens, or recreational rooms) added through extensions or remodeling.
numBedroomsPlus: If a home originally had 3 bedrooms, but an extra bedroom was added during a renovation, the numBedroomsPlus field would indicate 1 (the additional bedroom).
numBathroomsPlus: For a house that initially had 2 bathrooms, if another bathroom was added, the numBathroomsPlus would reflect this addition.
numKitchensPlus: In the case where a basement apartment was added to a home with 1 kitchen, the numKitchensPlus would indicate the additional kitchen.
numRoomsPlus: If an original home layout included a living room, dining room, and 2 bedrooms, and a den was added later, the numRoomsPlus would show the extra room.
If you're querying our API with the minBeds parameter and noticing listings with fewer bedrooms in the response than expected, this is likely due to how the minBeds parameter works.
numBedrooms: Refers to the number of above-grade bedrooms.
numBedroomsPlus: Refers to the number of below-grade bedrooms (such as in a basement).
When you query with minBeds, the system checks the sum of numBedrooms and numBedroomsPlus. For example, if you request listings with minBeds=4, you may receive a listing with 3 above-grade bedrooms (numBedrooms=3) and 1 below-grade bedroom (numBedroomsPlus=1), totaling 4 bedrooms.
If you want to restrict your search to above-grade bedrooms, you can use the maxBedsPlus parameter. Setting maxBedsPlus=0 ensures that only listings with above-grade bedrooms are returned.
For example:
https://api.repliers.io/listings?minBedrooms=4&maxBedroomsPlus=0
This request will provide listings with at least 4 above-grade bedrooms.
Please be aware that not all MLSs support the numBedroomsPlus field, so in some cases, this additional step may not be necessary. If your MLS doesn't support this, the minBedrooms parameter will effectively just refer to above-grade bedrooms.
What Does "Plus" Mean?
The "Plus" in these fields signifies rooms that have been added to the original layout of the home. For example:
numBedroomsPlus: Additional bedrooms added during renovations.
numBathroomsPlus: Additional bathrooms that were constructed after the home was originally built.
numKitchensPlus: Extra kitchens that were added, possibly as part of an in-law suite or basement apartment.
numRoomsPlus: Other types of rooms (such as offices, dens, or recreational rooms) added through extensions or remodeling.
Examples
numBedroomsPlus: If a home originally had 3 bedrooms, but an extra bedroom was added during a renovation, the numBedroomsPlus field would indicate 1 (the additional bedroom).
numBathroomsPlus: For a house that initially had 2 bathrooms, if another bathroom was added, the numBathroomsPlus would reflect this addition.
numKitchensPlus: In the case where a basement apartment was added to a home with 1 kitchen, the numKitchensPlus would indicate the additional kitchen.
numRoomsPlus: If an original home layout included a living room, dining room, and 2 bedrooms, and a den was added later, the numRoomsPlus would show the extra room.
Why am I getting listings with fewer bedrooms than expected when using minBeds?
If you're querying our API with the minBeds parameter and noticing listings with fewer bedrooms in the response than expected, this is likely due to how the minBeds parameter works.
Understanding numBedrooms and numBedroomsPlus:
numBedrooms: Refers to the number of above-grade bedrooms.
numBedroomsPlus: Refers to the number of below-grade bedrooms (such as in a basement).
When you query with minBeds, the system checks the sum of numBedrooms and numBedroomsPlus. For example, if you request listings with minBeds=4, you may receive a listing with 3 above-grade bedrooms (numBedrooms=3) and 1 below-grade bedroom (numBedroomsPlus=1), totaling 4 bedrooms.
How to search for only above-grade bedrooms:
If you want to restrict your search to above-grade bedrooms, you can use the maxBedsPlus parameter. Setting maxBedsPlus=0 ensures that only listings with above-grade bedrooms are returned.
For example:
https://api.repliers.io/listings?minBedrooms=4&maxBedroomsPlus=0
This request will provide listings with at least 4 above-grade bedrooms.
Note on MLS support:
Please be aware that not all MLSs support the numBedroomsPlus field, so in some cases, this additional step may not be necessary. If your MLS doesn't support this, the minBedrooms parameter will effectively just refer to above-grade bedrooms.
Updated on: 29/11/2024
Thank you!