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

> Muestra el MLS en Wix, WordPress o cualquier sitio con un código, conecta tu CRM con la API REST y recibe webhooks firmados. Gratis para agentes verificados.

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](/developers/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](/developers/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](/developers/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](/portal/register).
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](/funciones/pagina-web-para-agentes-inmobiliarios), que ya trae el MLS integrado.
- Si muestras todo el MLS, firma un [convenio de comisión](/funciones/convenios-de-comision-compartida) antes de promover propiedades de otros agentes.

## Cómo funciona, paso a paso
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.

## 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.

---
Página: https://multilistado.mx/funciones/widget-idx-y-api · Actualizado: 2026-10-28