Lineamientos, cambios y soporte

#Reglas para mostrar propiedades

Aplican al widget, la API, los feeds y la RESO Web API.

1. Crédito al agente listador. En cada propiedad de otro agente muestra su nombre y, si tiene, su inmobiliaria (agent.name, agency.name), y enlaza a la ficha (url). El widget lo hace automáticamente («Listada por…»).
2. Datos frescos. Guarda en caché 12 horas como máximo y quita lo que ya no esté publicado. Usa updated_since (API) o ModificationTimestamp (RESO) para sincronizar.
3. Nada de scraping. Usa la API, los feeds o el widget; no descargues páginas de multilistado.mx de forma automatizada. Respeta los límites de solicitudes.
4. Respeta las exclusiones. Nunca muestres una propiedad que la API no te devuelve: las marcadas por su propietario como «no autorizada en sitios de otros agentes» (idx_opt_out) y las importaciones con licencia de otros MLS ya vienen excluidas. No las obtengas por otras vías.
5. Ubicación y privacidad. Usa las coordenadas tal como vienen (aproximadas, salvo location.exact: true); no intentes deducir la dirección exacta. No publiques datos de compradores ni de propietarios.
6. Sin comisiones públicas. Las comisiones compartidas son información entre agentes y no se exponen; no las publiques aunque las conozcas.
7. Contenido tal cual. Puedes dar formato y traducir, pero no cambies precios, medidas ni características. Si ofreces traducción automática, indícalo.
8. Leads. Las solicitudes sobre propiedades de otros agentes que recibas por tu sitio se atienden en colaboración con el agente listador (el Multilistado es una red de colaboración entre agentes con licencia). Toda visita exige identificación verificada del comprador.
9. Marca. Puedes decir «Propiedades del Multilistado» y enlazar a multilistado.mx; no des a entender que eres Multilistado ni uses su logotipo como propio.

El incumplimiento puede llevar a revocar keys o widgets. Uso sujeto a los Términos y al Aviso de privacidad.

#Soporte

• Correo: contacto@multilistado.mx (incluye la URL que llamas, la hora y la respuesta; nunca envíes tu API key completa, basta el prefijo pbm_xxxxxxxx).
• MLS, brokers y vendors de EE. UU.: programa de socios.
• Código abierto (AGPL-3.0): github.com/probienesmexico.

#Versiones y compatibilidad

• /api/v1, el widget y los webhooks son estables: solo agregamos campos, parámetros y eventos opcionales. Ignora los campos que no conozcas.
• Un cambio incompatible irá en una versión nueva (/api/v2) y la anterior se mantendrá al menos 12 meses, con aviso en esta página.
• La descripción OpenAPI (/api/v1/openapi.json) indica su versión en info.version.
• /api/app/v1 es interna de la app del iPhone: no está soportada para terceros.

#Historial de cambios

#2026-09-30

• Centro de desarrolladores nuevo en /developers (español e inglés), con guías para WordPress, Wix, Squarespace, GoDaddy, Shopify, Webflow, Google Sites y Blogger, generador de código y referencia interactiva.
• OpenAPI 1.1.0: descripción completa y válida (esquemas de propiedad, lead, errores, límites y paginación).
• API: GET /properties y GET /properties/{id} ya no devuelven a otras keys propiedades con idx_opt_out ni de cuentas de prueba (antes sí; ahora coincide con el widget y los sitios).
• API: GET /leads y POST /leads devuelven una lista fija de campos documentados (ya no columnas internas).
• API: POST /properties con un external_id repetido responde 409 conflict con el id existente (antes, error 500).
• API: publicar, despublicar y retirar por API envía los webhooks listing.published / listing.unpublished; la respuesta 429 incluye Retry-After.

#Septiembre de 2026 (antes del 30)

• Widget IDX con buscador, mapa, fichas y leads para el dueño del widget; plugin de WordPress 1.0.0.
• RESO Web API: valores de catálogo con nombres del Data Dictionary 2.0, colecciones multivalor (any()/all()), now().

#Anteriores

• API REST v1, RESO Web API (Property, Media, Member, Office, Lookup), webhooks y feeds por cuenta.