{"openapi":"3.0.3","info":{"title":"Multilistado Open Data API","version":"1.0.0","description":"Read-only open data from Multilistado, the free MLS of licensed agents in Mexico: verified listings, agent verification against official state registries, the Estimado Multilistado home value range, and asking-price statistics by colonia. No key needed; 120 requests/min per IP. Please cite and link multilistado.mx. MCP server: https://multilistado.mx/mcp","contact":{"email":"info@multilistado.mx","url":"https://multilistado.mx/developers/open-data"}},"servers":[{"url":"https://multilistado.mx/api/open/v1"}],"paths":{"/listings":{"get":{"operationId":"searchListings","summary":"Search verified listings","parameters":[{"name":"q","in":"query","description":"Free text","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","description":"City, e.g. Tijuana","required":false,"schema":{"type":"string"}},{"name":"state","in":"query","description":"State","required":false,"schema":{"type":"string"}},{"name":"colonia","in":"query","description":"Neighborhood","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"house, apartment, land, office, commercial, warehouse, ranch, building (comma-separated)","required":false,"schema":{"type":"string"}},{"name":"op","in":"query","description":"sale | rent","required":false,"schema":{"type":"string"}},{"name":"min_price","in":"query","description":"Minimum price","required":false,"schema":{"type":"number"}},{"name":"max_price","in":"query","description":"Maximum price","required":false,"schema":{"type":"number"}},{"name":"currency","in":"query","description":"MXN | USD","required":false,"schema":{"type":"string"}},{"name":"beds_min","in":"query","description":"Minimum bedrooms","required":false,"schema":{"type":"integer"}},{"name":"bbox","in":"query","description":"Map box w,s,e,n","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"newest | price_asc | price_desc","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page","required":false,"schema":{"type":"integer"}},{"name":"lang","in":"query","description":"es | en","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listings","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/listings/{slug}":{"get":{"operationId":"getListing","summary":"Listing details (with Estimado Multilistado)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","description":"es | en","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listing","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/agents/verify":{"get":{"operationId":"verifyAgent","summary":"Is this person a licensed / registered real-estate agent? (official state registries + Multilistado-verified)","parameters":[{"name":"q","in":"query","description":"Name or registry folio","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Matches","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/agents/{slug}":{"get":{"operationId":"getAgent","summary":"Public profile of a verified agent and their listings","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agent","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/estimate":{"get":{"operationId":"estimateHomeValue","summary":"Estimado Multilistado: value range of a home from nearby asking prices","parameters":[{"name":"type","in":"query","description":"house | apartment | land","required":false,"schema":{"type":"string"}},{"name":"m2_built","in":"query","description":"Construction m²","required":true,"schema":{"type":"number"}},{"name":"m2_land","in":"query","description":"Lot m²","required":false,"schema":{"type":"number"}},{"name":"bedrooms","in":"query","description":"Bedrooms","required":false,"schema":{"type":"integer"}},{"name":"bathrooms","in":"query","description":"Bathrooms","required":false,"schema":{"type":"number"}},{"name":"city","in":"query","description":"City / municipality","required":false,"schema":{"type":"string"}},{"name":"colonia","in":"query","description":"Neighborhood","required":false,"schema":{"type":"string"}},{"name":"lat","in":"query","description":"Latitude","required":false,"schema":{"type":"number"}},{"name":"lng","in":"query","description":"Longitude","required":false,"schema":{"type":"number"}},{"name":"ocean","in":"query","description":"no | vista | frente","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Estimate","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/prices/colonias":{"get":{"operationId":"coloniaPrices","summary":"Asking-price statistics by colonia (≥ 5 listings)","parameters":[{"name":"municipality","in":"query","description":"e.g. Tijuana, Rosarito, Ensenada","required":false,"schema":{"type":"string"}},{"name":"colonia","in":"query","description":"Neighborhood name (partial)","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max rows","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Colonias","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/places":{"get":{"operationId":"suggestPlaces","summary":"Place suggestions (cities, colonias)","parameters":[{"name":"q","in":"query","description":"Text","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Places","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}