# Lineamientos, cambios y soporte

Las reglas que protegen a los agentes que publican en el Multilistado y a sus clientes, y cómo te avisamos de los cambios.

Fuente: https://multilistado.mx/developers/guidelines · Actualizado: 2026-09-30 · Otro idioma: https://multilistado.mx/developers/guidelines.md?lang=en

## 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](https://multilistado.mx/terminos) y al [Aviso de privacidad](https://multilistado.mx/privacidad).

## Soporte

- Correo: [contacto@multilistado.mx](mailto: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](https://multilistado.mx/socios-mls).
- Código abierto (AGPL-3.0): [github.com/probienesmexico](https://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](https://multilistado.mx/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.