Widget IDX, API y webhooks: el MLS en tu sitio y tu CRM

Cómo funciona

1. Crea tu widget en Portal → Más → Widget IDX.
2. Elige propiedades, filtros, vista, colores y dominios permitidos.
3. Copia el script o iframe, o instala el plugin de WordPress.
4. Pégalo en un bloque HTML de tu sitio y publica.
5. Para integraciones, crea una API key o un webhook.

Si ya tienes un sitio web en Wix, WordPress, Squarespace u otra plataforma, el widget IDX de Multilistado pone el buscador del MLS dentro de él: filtros, mapa, fichas y formulario de contacto, con tu logo y colores. Pegas un código una vez, las propiedades se actualizan solas y las solicitudes te llegan a ti. Si programas o tienes un CRM, también tienes una API REST con llaves propias y webhooks firmados. Todo es gratis para agentes verificados.

Widget IDX: el MLS en tu sitio actual

Qué configuras en el portal (Portal → Más → Widget IDX), sin tocar el código:

• Qué propiedades mostrar: todo Multilistado o solo las tuyas, y si incluyes las que están en trato.
• Filtros predeterminados, idioma y vista: cuadrícula, lista o mapa.
• Una barra con tu logo y teléfono, colores y modo claro u oscuro.
• Quién recibe las solicitudes (útil en inmobiliarias).
• Dominios permitidos, para que tu widget solo se muestre en tus sitios.

Cómo se inserta:

• Script (recomendado): una línea de código; la altura se ajusta sola al contenido.
• Iframe: para plataformas que aíslan el código, como Wix, Google Sites o GoDaddy.
• Plugin de WordPress «Multilistado IDX»: lo subes como .zip, pegas el ID de tu widget y usas el bloque o el código corto.

La documentación tiene pasos exactos para Wix, Squarespace, GoDaddy, Shopify, Webflow, Google Sites, Blogger y HTML, y un generador de código. Consulta la guía del widget.

Prospectos: cuando un visitante pide información o una visita desde el widget, el prospecto llega a tu bandeja en el portal y a tu correo, con el origen del widget para que sepas de dónde vino.

API REST v1

Para conectar tu propio sitio o CRM:

• Lee el inventario del MLS con búsqueda y filtros, y consulta cada propiedad.
• Administra tus propiedades: crear, actualizar, subir imágenes, publicar y despublicar.
• Crea prospectos desde tus formularios y consulta tus prospectos.
• Llaves (API keys) de solo lectura o de lectura y escritura. Se crean en Portal → Más → API, se muestran una sola vez y puedes revocarlas.
• Límite de 600 solicitudes cada 10 minutos por llave. Hay descripción OpenAPI 3.0 y una referencia interactiva.

Por seguridad la llave va en la cabecera Authorization, nunca en la URL, y la API se llama desde tu servidor, no desde el navegador de tus visitantes. Más en la documentación de la API.

Webhooks

Multilistado envía un POST JSON a tu servidor cuando pasa algo:

• lead.created y lead.updated: llega un prospecto nuevo o cambias su etapa.
• listing.published, listing.updated y listing.unpublished: cambios en tus propiedades.

Cada envío lleva la firma HMAC-SHA256 en la cabecera X-PBM-Signature para que compruebes que viene de Multilistado. El botón «Probar» envía un evento de prueba y el portal muestra el último estado de entrega. Más en la guía de webhooks.

Qué datos nunca salen

La comisión compartida y los demás datos de comisión solo los ven agentes verificados dentro de Multilistado: no salen en el widget, la API ni los feeds. Tampoco salen la dirección o las coordenadas exactas si el agente no eligió mostrarlas, ni datos privados de propietarios o compradores.

Cómo empezar

1. Entra con tu cuenta verificada. Si no tienes, regístrate con tu licencia.
2. Crea tu widget en Portal → Más → Widget IDX y guarda la configuración.
3. Copia el código (script o iframe) o instala el plugin de WordPress.
4. Pégalo en un bloque de HTML de tu sitio y publica.
5. Si vas a programar, crea una API key o un webhook en el portal.

Consejos

• Prueba en computadora y celular: busca, abre una propiedad y envía una solicitud de prueba.
• Si usas dominios permitidos en Wix, agrega también los dominios que Wix usa para incrustar código; la guía los indica.
• Si no tienes sitio web, quizá te conviene más la página web de Multilistado, que ya trae el MLS integrado.
• Si muestras todo el MLS, firma un convenio de comisión antes de promover propiedades de otros agentes.

Preguntas frecuentes

¿Funciona en Wix, WordPress o Shopify?

Sí. Hay pasos para Wix, Squarespace, GoDaddy, Shopify, Webflow, Google Sites, Blogger y HTML, y un plugin para WordPress.

¿A quién le llegan los prospectos del widget?

A ti, en tu portal y tu correo, marcados con el widget como origen. En inmobiliarias se puede elegir quién los recibe.

¿La API muestra la comisión compartida?

No. Los datos de comisión solo los ven agentes verificados dentro de Multilistado; no salen en el widget, la API ni los feeds.

¿Tiene costo la API?

No. El widget, la API y los webhooks son gratis para agentes verificados; la API tiene un límite de 600 solicitudes cada 10 minutos por llave.