propiedades.com APIpropiedades.com ↗
Search Mexico property listings, get location autocomplete, and retrieve full listing details including price, amenities, and gallery images via the Propiedades.com API.
curl -X GET 'https://api.parse.bot/scraper/8e472e31-c37a-4cf9-abab-04247e5feb37/search_location?query=Guadalajara' \ -H 'X-API-Key: $PARSE_API_KEY'
Get location suggestions for a search query. Returns a list of neighborhoods and areas in Mexico with their associated URL paths on propiedades.com, useful for feeding into the search_listings endpoint.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search query for a city, neighborhood, or area in Mexico (e.g. 'Guadalajara', 'Ciudad de Mexico', 'Monterrey'). |
{
"type": "object",
"fields": {
"success": "boolean indicating if the request was successful",
"directions": "array of location objects, each with id, label, latitude, longitude, url, and is_state fields"
},
"sample": {
"data": {
"success": true,
"directions": [
{
"id": 55990,
"ord": 1,
"url": "https://propiedades.com/guadalajara-centro-guadalajara/residencial-renta",
"label": "Guadalajara Centro, Guadalajara, Jalisco",
"is_state": true,
"latitude": 20.687,
"longitude": -103.266,
"inverted_url": "https://propiedades.com/guadalajara-centro-guadalajara/residencial-renta",
"previous_search": false
}
]
},
"status": "success"
}
}About the propiedades.com API
This API exposes 3 endpoints for accessing real estate listings on propiedades.com, one of Mexico's major property portals. Use search_location to resolve city or neighborhood queries into location slugs, pipe those slugs into search_listings to retrieve paginated property results, and call get_listing_detail to pull full listing data including gallery images, pricing, and amenities for any individual property.
Location Resolution and Search
The search_location endpoint accepts a query string — a city, neighborhood, or area name in Mexico such as 'Guadalajara' or 'Monterrey' — and returns an array of location objects under the directions field. Each object includes id, label, latitude, longitude, url, and is_state, letting you identify the correct geographic scope before searching. The url field from each result serves directly as the location_path input for the listings endpoint.
Paginated Listing Search
The search_listings endpoint takes a location_path (e.g. '/df/residencial-venta') and an optional page integer. Each response includes the resolved url, the current page number, a total count of listings on that page, and a listings array. Each listing object contains @type, url, datePosted, and an offers object that holds price, description, address, and amenities — all sourced from structured data attached to each listing.
Individual Listing Details
The get_listing_detail endpoint accepts a listing url or slug (e.g. '/inmuebles/casa-en-venta-...') and returns the full property record: name, description, offers, and a gallery_images object containing photo assets fetched from a separate data source. This endpoint is best called after identifying a listing URL from search_listings results.
- Build a Mexico property search tool that maps location names to listing results using
search_locationandsearch_listings. - Aggregate rental and sale listings across multiple Mexico cities by iterating
location_pathvalues with pagination. - Display property detail pages with gallery images and amenities by calling
get_listing_detailon any listing URL. - Track listing prices over time by periodically fetching
offers.pricefromsearch_listingsorget_listing_detail. - Geocode Mexico neighborhoods by extracting
latitudeandlongitudefromsearch_locationresults. - Filter newly posted properties by comparing
datePostedvalues returned insearch_listings. - Power a real estate comparison tool by pulling
amenities,address, andpricefrom multiple listing detail calls.
| 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 propiedades.com offer an official developer API?+
What does `search_listings` return and can I filter by property type or price range?+
listings array where each entry has @type, url, datePosted, and an offers object containing price, description, address, and amenities. Filtering by property type or price range is not a built-in parameter — results depend on the location_path you supply. The location slug itself typically encodes transaction type (e.g. residencial-renta vs residencial-venta). You can fork this API on Parse and revise it to add server-side filtering by price or property type.Are listings outside Mexico covered?+
Does the API return contact information for property agents or sellers?+
get_listing_detail and search_listings endpoints return listing content — price, description, address, amenities, and images — but do not expose agent names, phone numbers, or email addresses. You can fork this API on Parse and revise it to add an endpoint that extracts contact fields from individual listing pages where that data is present.How does pagination work in `search_listings`?+
page parameter to move through result pages. The response includes a page field confirming the current page and a total field indicating how many listings were returned on that page. There is no total_pages or total_count field in the response, so you will need to paginate until a page returns fewer results than expected to detect the end of results.