Piso en Chamberí
420.000 €
Madrid
- 78 m²
- 3 hab.
- 1 baño
De la API a tu próxima web inmobiliaria.
Conecta el catálogo y las solicitudes de tu web con el trabajo diario de tu agencia en Vestta.
Explorar documentación
Hablar sobre una integración api-docs.vestta.app
GET/properties
properties:read
{
"status": "ok",
"data": [{
"id": 1043,
"price": 420000,
"city": "Madrid"
}]
}/leads/inquiries
Lucía Martín
Demandante
Origen: web
Preferencias de búsqueda
- Madrid
- Venta · Apartamento
- Hasta 500.000 € · Mín. 3 dormitorios
Datos de ejemplo · API pública de propiedades y leads
El portal api-docs.vestta.app está en preparación. Puedes hablar con Vestta sobre una integración.
De API a producto real.
Los datos salen a tu web. Las solicitudes vuelven a tu agencia.
Del CRM a la web
GET/properties
?operation=venta&limit=12properties:read
Ver respuesta JSON
{
"status": "ok",
"data": [
{
"id": 1043,
"price": 420000,
"city": "Madrid",
"size_total": 78
},
{
"id": 1187,
"price": 695000,
"city": "Madrid",
"size_total": 120
}
],
"count": 2,
"limit": 12,
"offset": 0
}data · count · limit · offset
{
"status": "ok",
"data": [
{
"id": 1043,
"price": 420000,
"city": "Madrid",
"size_total": 78
},
{
"id": 1187,
"price": 695000,
"city": "Madrid",
"size_total": 120
}
],
"count": 2,
"limit": 12,
"offset": 0
}Tu web inmobiliaria
VentaMadrid
Piso en Chamberí
420.000 €
Madrid
- 78 m²
- 3 hab.
- 1 baño
Ático en Salamanca
695.000 €
Madrid
- 120 m²
- 3 hab.
- 2 baños
2 propiedades de ejemplo
Consulta el catálogo público, filtra y presenta cada inmueble con tu propio diseño.
De la web a Vestta
POST /leads/inquiries
Cuerpo JSON · leads:ingest
{
"name": "Lucía Martín",
"type": "demandante",
"phone_number_1": "+34600000000",
"notes": "Busco vivienda en Madrid",
"source": "web"
}Ver solicitud completa
{
"name": "Lucía Martín",
"type": "demandante",
"phone_number_1": "+34600000000",
"source": "web",
"notes": "Busco vivienda en Madrid",
"search_preferences": [
{
"operations": [
"venta"
],
"property_types": [
"apartamento"
],
"apartamento": {
"price_max": 500000,
"bedrooms_min": 3
},
"locations": [
{
"name": "Madrid"
}
]
}
]
}/leads/inquiries
Lucía Martín
Demandante
Origen: web
Preferencias de búsqueda
- Madrid
- Venta · Apartamento
- Hasta 500.000 € · Mín. 3 dormitorios
La solicitud entra como lead. El CRM puede buscar propiedades compatibles según sus criterios. Si no vas a programar nada, revisa las integraciones que puedes activar desde Vestta.
Caso real
Una web alimentada desde Vestta.
Tierras de Ibiza conecta su catálogo público y las solicitudes de su web con el CRM.
TIERRAS DE IBIZA REAL
ESTATE
TIERRAS DE IBIZACatálogo públicoVentaTipo de inmueblePrecio
Villa con vistas al mar
2.450.000 €
Ibiza
- 285 m²
- 4 hab.
- 3 baños
Apartamento con terraza
675.000 €
Ibiza
- 112 m²
- 2 hab.
- 2 baños
Vista ilustrativa con datos sintéticos. No reproduce el catálogo actual de Tierras de Ibiza.
Una cartera conectada al CRM
Ver su web
API
Web
Solicitudes hacia Vestta
Modelo
Un modelo que conecta el contexto.
Una propiedad, quien la busca y la oportunidad que los relaciona. La información conserva su contexto dentro de Vestta.
Cliente
Lucía Martín
Preferencias de búsqueda
Entrada desde leads
Propiedad
Piso en Chamberí
420.000 €
Consulta pública
Relaciona cliente y propiedad
Oportunidad
Cliente ↔ Propiedad
Compatibilidad por criterios
Documentos
Información de la operación
- Nota simple.pdf
- Plano.pdf
Oportunidades y documentos: contexto del CRM.
Seguridad
Cada integración, con su acceso.
Las API keys pertenecen a una agencia y cada operación comprueba el scope necesario.
Conocer la seguridad de VesttaAPI key · Web de la agencia Activa
AC_LIVE_••••••••
X-Api-Key
- properties:read
- Consultar catálogo público
- leads:read
- Consultar leads
- leads:ingest
- Recibir solicitudes
Permisos asignados según la integración.
Revocación · Caducidad opcional · Último uso
Conserva la credencial en tu servidor.
Experiencia de desarrollo
Menos adivinar. Más construir.
Requests HTTP, respuestas JSON y un contrato que puedes consultar.
HTTP + JSON
Campos y respuestas explícitos
Filtros y paginación
limit · offset · operación · precio
Errores HTTP
401 · 422 · 500
API v1
/v1/ext · OpenAPI
Dos ejemplos para empezar.
cURL · Ejecuta las llamadas desde tu servidor. Usa una API key con los scopes necesarios.
Consultar propiedades
properties:readcurl 'https://api.vestta.app/v1/ext/properties?operation=venta&limit=12' \
-H "X-Api-Key: $VESTTA_API_KEY"Respuesta de ejemplo (200)
{
"status": "ok",
"data": [{"id":1043,"price":420000}],
"count": 1,
"limit": 12,
"offset": 0
}Tu catálogo, con datos de Vestta
Piso en Chamberí · 420.000 €
Madrid · 78 m² · 3 dormitorios
Recibir una solicitud
leads:ingestcurl -X POST 'https://api.vestta.app/v1/ext/leads/inquiries' \
-H "X-Api-Key: $VESTTA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"name": "Lucía Martín",
"type": "demandante",
"phone_number_1": "+34600000000",
"source": "web"
}'Respuesta de ejemplo (200)
{
"status": "ok",
"lead_id": 1043
}Lucía Martín
Demandante · Origen: web
+34 600 000 000 · Contacto sintético
Solicitud recibida
lead_id: 1043 · Ejemplo de contacto incorporado al CRM
Datos de ejemplo. Consulta el esquema completo en la documentación (en preparación).
Hoja de ruta
Lo que queremos conectar después.
En preparación · No disponible en la API actual · Sin fechas anunciadas.
Creación de propiedades
Un endpoint para incorporar inmuebles.
Creación general de clientes
Más allá de las solicitudes y leads actuales.
Webhooks
Mensajes, correos y oportunidades como eventos.
MCP
Conexiones con herramientas y asistentes compatibles.
Portal de documentación API
Guías y referencia pública en api-docs.vestta.app.
Construyamos tu próxima integración.
Consulta el contrato de la API o cuéntanos qué quieres conectar.
Explorar documentación
Hablar sobre una integración api-docs.vestta.app