Saltar al contenido principal

v1.0.0 · Contrato estable

Spot2 Integraciones

Documentación técnica para integrar su CRM con el marketplace de bienes raíces comerciales de Spot2.

Ver documentación Inicio rápido

Protocolo de consulta
Esquema de propiedad
Reglas QA
Webhooks

Campos obligatorios para publicar

Cada propiedad debe incluir ubicación georreferenciada (`location.latitude`, `location.longitude`) y contacto comercial (`contact.name`, `contact.email`, `contact.phone`).

GET/api/v1/spot2/properties

GET /api/v1/spot2/properties?updated_since=2026-07-01T00:00:00Z&offset=0&limit=200

{
  "data": [
    {
      "external_id": "prop-001",
      "property_type": "oficina",
      "modality": "rent",
      "updated_at": "2026-07-01T10:00:00Z",
      "price": {
        "rent_price": 45000,
        "currency": "MXN"
      },
      "location": {
        "latitude": 19.4326,
        "longitude": -99.1332,
        "street": "Av. Presidente Masaryk",
        "city": "Ciudad de México",
        "state": "Ciudad de México",
        "postal_code": "11560"
      },
      "contact": {
        "name": "Juan Pérez",
        "email": "contacto@spot2.mx",
        "phone": "+521234567890"
      },
      "photos": ["https://cdn.su-crm.com/01.jpg"],
      "amenities": ["air_conditioning", "parking"],
      "description": "Oficina en planta baja con acceso 24/7"
    }
  ],
  "meta": {
    "next": "https://su-crm.com/api/v1/spot2/properties?updated_since=2026-07-01T00:00:00Z&offset=200&limit=200"
  }
}

Cómo funciona

Tres pasos. Todo automático.

1

Usted expone su API

Un endpoint GET con las publicaciones seleccionadas para Spot2 y otro con las eliminadas o retiradas. Nosotros lo consultamos en ciclos programados.

→

2

Nosotros validamos

Cada propiedad pasa por reglas de calidad. Las que cumplen se publican, las que no se rechazan con motivo.

→

3

Publicamos en Spot2

Las propiedades válidas aparecen en el marketplace. Recibe el resultado vía webhook en tiempo real.

Explore la documentación

Todo lo que necesita para integrar su CRM.

GET/api/v1/spot2/properties

Feed de publicaciones seleccionadas para Spot2. Paginado con `updated_since`.

Clave API (encabezado)

GET/api/v1/spot2/properties/deleted

Feed de IDs eliminados o retirados de Spot2. Con parámetro `since`.

Clave API (encabezado)

20 reglas BLOCK

Validación automática de cada propiedad. Las que pasan, se publican.

Resultado vía webhook

POST/api/webhooks/spot2/feedback

Webhook opcional para notificaciones de publicación o rechazo.

Esquema de propiedad·Ciclo de vida·Ejemplos·Seguridad

Por dónde empezar

Tres caminos según lo que necesite.

Inicio rápido

Guía paso a paso para integrar su CRM en minutos.

Esquema de propiedad

La referencia completa de campos, tipos y validaciones.

Ejemplos

Casos concretos de request y response con datos reales.