casasyterrenos.com APIcasasyterrenos.com ↗
Search and retrieve Mexico real estate listings from casasyterrenos.com. Access property details, pricing, seller contacts, and coordinates via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/be39d005-39e6-4654-b189-f96e0e6c94ce/search_listings?state=jalisco&operation=venta&property_type=casa' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for real estate listings (houses, apartments, land, etc.) by state, municipality, property type, and operation. Returns paginated results from the Meilisearch-backed search index with up to 40 listings per page.
| Param | Type | Description |
|---|---|---|
| city | string | Municipality/city name slug to filter within the state (e.g., 'monterrey', 'guadalajara', 'zapopan'). Hyphens are replaced with spaces and title-cased for matching. |
| page | integer | Page number (0-indexed). Each page returns up to 40 results. |
| sort | string | Sort order. Accepted values: 'price_asc', 'price_desc'. Omitting sorts by outstanding (featured) listings first. |
| staterequired | string | Mexican state name slug. Verified working values include: 'jalisco', 'nuevo-leon', 'ciudad-de-mexico', 'aguascalientes', 'baja-california', 'chihuahua', 'guanajuato', 'puebla', 'queretaro', 'quintana-roo', 'yucatan'. Full list of accepted slugs corresponds to all 32 Mexican states in lowercase hyphenated form. |
| parking | integer | Minimum number of parking spaces. |
| bedrooms | integer | Minimum number of bedrooms. |
| bathrooms | integer | Minimum number of bathrooms. |
| max_price | integer | Maximum price in MXN. Filters on priceSale for venta, priceRent for renta. |
| min_price | integer | Minimum price in MXN. Filters on priceSale for venta, priceRent for renta. |
| operation | string | Operation type. Accepted values: 'venta' (sale), 'renta' (rent). |
| property_type | string | Property type slug. Accepted values: 'casa', 'departamento', 'terreno', 'local', 'edificio', 'oficina', 'bodega', 'consultorio', 'granja', 'hotel', 'rancho', 'cabana', 'villa', 'nave-industrial'. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"limit": "integer, max results per page (40)",
"total": "integer, estimated total number of matching listings",
"properties": "array of property listing objects with id, name, state, municipality, neighborhood, type, surface, construction, rooms, bathrooms, parkingLots, currency, priceSale, priceRent, photoPreview, canonical, slugs, images, broker, lastUpdate"
},
"sample": {
"data": {
"page": 0,
"limit": 40,
"total": 8000,
"properties": [
{
"id": 3806077,
"name": "CASA EN VENTA COL , SAN JUAN DE DIOS II , GUADALAJARA JAL.",
"type": "Casa",
"rooms": 8,
"slugs": {
"renta": "",
"venta": "/propiedad/casa-venta-abasolo-san-juan-de-dios-ii-guadalajara-jal-3806077",
"traspaso": "",
"canonical": "/propiedad/casa-venta-abasolo-san-juan-de-dios-ii-guadalajara-jal-3806077"
},
"state": "Jalisco",
"broker": {
"name": "John Doe",
"email": "[email protected]",
"phone": "+1 (555) 012-3456",
"whatsapp": "+1 (555) 012-3456"
},
"images": [
"https://cdn.casasyterrenos.com/img_casas/9cd38392.jpeg"
],
"surface": 190,
"currency": "MXN",
"bathrooms": 4,
"canonical": "/propiedad/casa-venta-abasolo-san-juan-de-dios-ii-guadalajara-jal-3806077",
"priceRent": "0",
"priceSale": 4500000,
"lastUpdate": "2026-03-24T18:48:53.695668",
"parkingLots": 0,
"construction": 309,
"municipality": "Guadalajara",
"neighborhood": "SAN JUAN DE DIOS II",
"photoPreview": "https://cdn.casasyterrenos.com/img_casas/9cd38392-cf95-46e7-a6f6-8fdd2803166c.jpeg"
}
]
},
"status": "success"
}
}About the casasyterrenos.com API
The Casas y Terrenos API exposes 2 endpoints to search and retrieve real estate listings across Mexico. Use search_listings to query properties by state, municipality, type, and price with up to 40 results per page, or call get_listing_detail to pull full property data including coordinates, seller contact information, amenity features, and an HTML description for any individual listing.
What the API covers
The API indexes residential and land listings from casasyterrenos.com across Mexican states. search_listings accepts a required state slug (e.g., jalisco, nuevo-leon, ciudad-de-mexico) and optional filters for city, bedrooms, bathrooms, parking, and max_price. Results are paginated with a 0-indexed page parameter; each page returns up to 40 listing objects alongside a total count of estimated matches. Sorting by price_asc or price_desc is supported; omitting the sort parameter returns featured listings first.
Listing search response fields
Each object in the properties array from search_listings includes the listing id, name, state, municipality, neighborhood, type, surface area, construction area, room count, and bathroom count — enough to filter and rank candidates before fetching full detail. The total field reflects the estimated result count for the query, useful for building pagination controls.
Full listing detail
get_listing_detail takes a slug_or_url obtained from search results (a full path like /propiedad/<slug> or just the slug portion) and returns a richer payload. Key fields include features (an object covering age, area, construction, bathrooms, halfBathrooms, levels, parking, and rooms), a coords object with lat and lng, an images array with original URLs and alt text, a description field in HTML, and a seller object carrying id, name, email, phone, and whatsapp. A contactCard object provides supplementary business contact details such as business_name and phones.
Geographic scope and filtering
Coverage is limited to listings active on casasyterrenos.com in Mexico. The city filter uses municipality slugs with hyphens for multi-word names. Price filtering via max_price applies to sale price (priceSale) for purchase listings and to rental price (priceRent) for rental listings, depending on the operation type specified in the query.
- Build a property search interface filtered by Mexican state, city, bedroom count, and budget using
search_listings - Aggregate seller contact details (phone, WhatsApp, email) from
get_listing_detailfor lead generation in real estate CRMs - Plot listings on a map using the
coordslat/lng values returned byget_listing_detail - Compare surface area, construction area, and parking across paginated search results to build a valuation dataset
- Monitor new listings in a specific municipality by polling
search_listingswithsort=price_ascand amax_pricethreshold - Populate a property detail page with images, HTML description, and amenity features pulled from
get_listing_detail
| 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 casasyterrenos.com have an official developer API?+
How does pagination work in `search_listings`?+
page parameter is 0-indexed — the first page is page=0. Each page returns up to 40 listings. The total field in the response gives an estimated count of all matching results, so you can calculate the number of pages needed to walk the full result set.Does `search_listings` support filtering by both sale and rental listings simultaneously?+
max_price filter targets either priceSale or priceRent depending on the operation type in the query. The current endpoint filters within one operation context at a time rather than across both simultaneously. You can fork this API on Parse and revise it to add a combined or cross-operation search endpoint.Does the API return historical price changes or listing activity over time?+
What seller information is available, and is agent profile data included?+
seller object in get_listing_detail includes id, name, email, phone, and whatsapp. The contactCard object adds business_name and phones. Full agent profile pages or portfolio listings per agent are not covered by the current endpoints. You can fork this API on Parse and revise it to add an agent-level listings endpoint.