Coldwell Banker APIcoldwellbanker.com.mx ↗
Access Coldwell Banker Mexico property listings for sale and rent. Get titles, prices, dimensions, images, agent contacts, and MLS codes via 2 REST endpoints.
What is the Coldwell Banker API?
The Coldwell Banker Mexico API exposes 2 endpoints covering the full coldwellbanker.com.mx property database across Mexican states. Use list_properties to retrieve paginated summaries with titles, pricing, dimensions, photos, and office info, filtered by operation type, state, city, or price range. Use get_property_detail to pull a single listing's complete data: all images, MLS code, floor count, parking details, amenities, and agent contact information.
curl -X GET 'https://api.parse.bot/scraper/be1b4a16-6604-4dcd-972d-3bee216de763/list_properties?page=0&operation=VENTA' \ -H 'X-API-Key: $PARSE_API_KEY'
List properties from the Coldwell Banker Mexico database with pagination. Returns property summaries including title, type, address, pricing, dimensions, photos, and office info. Supports filtering by operation type (sale/rent), price range, and location. The total database contains thousands of properties; paginate with page/size to traverse the full set. Each page returns up to 50 results.
| Param | Type | Description |
|---|---|---|
| city | string | Filter by municipality/city name (e.g. 'Monterrey', 'Álvaro Obregón'). |
| page | integer | Zero-based page number for pagination. |
| size | integer | Number of results per page, max 50. |
| state | string | Filter by state name (e.g. 'Ciudad de México', 'Nuevo León', 'Jalisco'). |
| operation | string | Type of operation: VENTA (sale) or RENTA (rent). |
| price_max | number | Maximum price filter (in the property's listed currency). |
| price_min | number | Minimum price filter (in the property's listed currency). |
| property_type_id | integer | Filter by property type ID from the site's catalog. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"size": "integer page size used",
"properties": "array of property summary objects with id, title, type, address, prices, dimensions, photos, office info",
"total_count": "integer total number of matching properties across all pages",
"has_next_page": "boolean indicating if more pages are available"
},
"sample": {
"data": {
"page": 0,
"size": 5,
"properties": [
{
"type": "Terreno",
"title": "TERRENO EN VENTA EN RAFAEL BUELNA EN MAZATLÁN",
"photos": [
{
"tipo": "IMAGEN",
"enlaceArchivo": "https://cb-crm.s3.us-west-2.amazonaws.com/upload/propiedad/5533/espacios-interiores/general/mazatlan-terreno-venta.jpeg"
}
],
"prices": [
{
"moneda": "MXN",
"precio": 65531200,
"operacion": "Venta"
}
],
"status": "ACTIVA",
"address": {
"cp": "82269",
"pais": "Mexico",
"calle": "AV. RAFAEL BUELNA",
"ciudad": "Sinaloa",
"colonia": "Mazatlán (Gral. Rafael Buelna)",
"municipio": "Mazatlán",
"numExterior": "S/N"
},
"bedrooms": 1,
"land_use": "RESIDENCIAL",
"bathrooms": 0,
"furnished": "No",
"office_id": 101,
"type_value": "TERRENO",
"coordinates": [
-11848129.14,
2661893.73
],
"office_name": "Coldwell Banker Comarca",
"property_id": 5533,
"land_area_m2": 9391,
"global_luxury": null,
"half_bathrooms": null,
"parking_spaces": 0,
"construction_area_m2": 0
}
],
"total_count": 6286,
"has_next_page": true
},
"status": "success"
}
}About the Coldwell Banker API
Searching and Filtering Properties
The list_properties endpoint accepts up to eight optional parameters. Set operation to VENTA for sale listings or RENTA for rentals. Narrow results geographically with state (e.g. 'Nuevo León', 'Ciudad de México') and city (e.g. 'Monterrey', 'Álvaro Obregón'). Price brackets are controlled by price_min and price_max, which operate in the currency of the listed property. Pagination is zero-based via page, with up to 50 results per request controlled by size. Each response includes total_count and has_next_page so you can walk the full result set programmatically.
Property Summary Response Shape
Each item in the properties array returned by list_properties contains the property id, title, type, address fields, pricing objects, square-metre dimensions, representative photo URLs, and office information. These summaries are sufficient for building search result UIs or populating databases for comparison tools, but for the full description text, all image variants, and granular feature sets you need get_property_detail.
Detailed Listing Data
get_property_detail takes a single required parameter—property_id as a numeric string from the list results—and returns a substantially richer object. Key fields include mls (the MLS reference code), prices (an array of pricing objects covering operation type, amount, currency, and negotiation notes), images (an array with both small and large URL variants, plus video objects), floors, parking details, latitude and geographic coordinates, property status (e.g. ACTIVA), amenities, condominium details, points of interest, visiting hours, property rules, and an owner object containing both the listing agent and the Coldwell Banker office contact data.
Coverage and Scope
The database spans listings across Mexican states including Jalisco, Nuevo León, and Ciudad de México, and covers residential and commercial property types filterable via property_type_id. All data reflects what is publicly listed on coldwellbanker.com.mx. Coldwell Banker Mexico does not publish an official public developer API for this database.
The Coldwell Banker API is a managed, monitored endpoint for coldwellbanker.com.mx — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when coldwellbanker.com.mx changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official coldwellbanker.com.mx API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate Mexican real estate listings from Coldwell Banker alongside other brokerages for a property comparison portal.
- Build a rental market tracker for specific Mexican cities using
operation=RENTAand thecityfilter. - Extract MLS codes and agent contact data from
get_property_detailto seed a CRM with Mexico City leads. - Monitor price changes across a saved set of property IDs by polling
get_property_detailperiodically. - Generate a curated feed of luxury listings by combining
price_min,state, andproperty_type_idfilters inlist_properties. - Populate a map-based property search UI using the
latitudeand geographic coordinates returned in detail responses. - Build an investment analysis tool by collecting
prices,dimensions, andfloorsfields across paginated sale listings.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Coldwell Banker Mexico have an official developer API?+
How does pagination work in `list_properties`, and how do I know when I've reached the last page?+
page=0 for the first page, page=1 for the second, and so on. The response includes total_count (the total number of matching listings across all pages) and has_next_page (a boolean). When has_next_page is false, you've retrieved all results for that query. The maximum page size is 50 results, set via the size parameter.Does `list_properties` return all property photos, or just thumbnails?+
list_properties include representative photo URLs but not the complete image set. The full images array—with both small and large URL variants for every photo, plus any video objects—is only returned by get_property_detail for a specific property ID.Are neighborhood-level or colonia filters available?+
list_properties filters cover state, city (municipality), operation, price_min, price_max, and property_type_id. Sub-city filtering by colonia or neighborhood is not currently exposed as a parameter. You can fork this API on Parse and revise it to add a colonia filter if that granularity is available in the underlying data.Does the API cover sold or off-market properties, or only active listings?+
status field in get_property_detail reflects the listing state (e.g. ACTIVA), but historical sold records and off-market properties are not currently covered. You can fork this API on Parse and revise it to target any additional listing states if they are accessible in the source.