Propiedades.com Search API returns up to 47 listings per page for sale or rent in one or more locations. Filter by type, subtype, price, built area, exact bedrooms and bathrooms, amenities and auctions, and sort by price or bedrooms. Every item satisfies the filters you sent; items that break a filter are never returned and are counted in excluded_by_filters. pagination.total_items is the total the site reports for the same filters, before the exact bedroom and bathroom rule. A page past the last returns an empty list. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
13 optional filters available.
string
Required
Required. Location id from the autocomplete route. Send a comma list of up to 10 ids to search several areas. Example: 150028.
1234567890
string
Optional
sale (default), rent or both.
example
string
Optional
residential (default), commercial or industrial.
example
string
Optional
A subtype of the type. residential: apartments, houses, residential-land, condominium-houses. commercial: offices, commercial-land, buildings, retail-spaces. industrial: industrial-warehouses. Omit for all. A subtype from another type returns 422.
example
number
Optional
Minimum price in MXN. Listings priced in another currency are left out when a price filter is set.
10
number
Optional
Maximum price in MXN. Listings priced in another currency are left out when a price filter is set.
10
number
Optional
Minimum built area in square metres.
10
number
Optional
Maximum built area in square metres.
10
integer
Optional
Exact bedroom count. Rows with a different count are removed, so a page can hold fewer than 47 items.
10
integer
Optional
Exact bathroom count. Rows with a different count are removed, so a page can hold fewer than 47 items.
10
boolean
Optional
true to return foreclosure auction listings (remates) only.
true
array
Optional
Comma list or repeated parameter of: nuevo, usado, alberca, jardin, mascotas, amueblado, estacionamientos.
["example"]
string
Optional
price_asc, price_desc, bedrooms_asc or bedrooms_desc. Default is the site relevance order. price_desc is not strictly sorted because promoted listings come first. There is no date sort.
relevance
integer
Optional
1-based page number, 1 to 500. 47 listings per page. A page past the last one returns an empty list.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"items": [
{
"id": 31599911,
"url": "https://propiedades.com/inmuebles/departamento-en-renta-andres-bello-polanco-iv-seccion-df-31599911",
"type": "Residencial",
"flags": {
"new": false,
"auction": false,
"showroom": false,
"exclusive": false,
"off_market": false,
"highlighted": true,
"whatsapp_verified": true
},
"price": 110000,
"title": "Departamento en renta Andr\u00e9s Bello, Col. Polanco IV Secci\u00f3n",
"address": {
"city": "Miguel Hidalgo",
"state": "DF / CDMX",
"colony": "Polanco IV Secci\u00f3n",
"street": "Andr\u00e9s Bello",
"zipcode": "11550",
"full_address": "Andr\u00e9s Bello, Col. Polanco IV Secci\u00f3n C.P. 11550, Miguel Hidalgo",
"municipality": "Miguel Hidalgo"
},
"purpose": "Renta",
"subtype": "Departamento",
"type_id": 1,
"bedrooms": 3,
"currency": "MXN",
"latitude": 19.4303847,
"amenities": {
"pool": false,
"terrace": true,
"elevator": true,
"furnished": false,
"pets_allowed": true,
"private_security": true
},
"bathrooms": 3,
"longitude": -99.1868662,
"thumbnail": "https://propiedadescom.s3.amazonaws.com/files/292x200/DF-CDMX-Polanco-IV-Seccion-Andres-Bello-Miguel-Hidalgo-0-31599911.png",
"purpose_id": 2,
"subtype_id": 1,
"modified_at": "14/10/2026",
"photo_count": 25,
"published_at": "2026-07-23 01:19:20",
"built_area_m2": 317,
"parking_spaces": 2,
"days_listed_label": "3 meses en Propiedades.com"
}
],
"location": {
"id": "150028",
"city": "Zona Polanco",
"label": "Zona Polanco, Ciudad de M\u00e9xico / CDMX",
"state": "Ciudad de M\u00e9xico / CDMX",
"colony": null
},
"pagination": {
"page": 1,
"per_page": 47,
"next_page": 2,
"total_items": 1185,
"total_pages": 26
},
"excluded_by_filters": 0
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"location_id": [
"The location id field is required."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Propiedades.com could not be reached, or returned data that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Propiedades.com could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.