Skip to main content

v1.0.0 · Standard contract

Spot2 Integrations

Technical documentation for integrating your CRM with the Spot2 commercial real estate marketplace.

View documentation Quickstart

Pull protocol
Property schema
QA rules
Webhooks

Required fields to publish

Each property must include georeferenced location (`location.latitude`, `location.longitude`) and commercial contact (`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"
  }
}

How it works

Three steps. Fully automatic.

1

You expose your API

A GET endpoint with listings selected for Spot2 and another with deleted or removed ones. We query them on scheduled cycles.

→

2

We validate

Each property goes through quality rules. Those that pass are published, those that don’t are rejected with a reason.

→

3

We publish on Spot2

Valid properties appear on the marketplace. You receive the result via webhook in real time.

Integration contract

The pieces you need to expose to integrate.

GET/api/v1/spot2/properties

Feed of listings selected for Spot2. Paginated with `updated_since`.

API key (header)

GET/api/v1/spot2/properties/deleted

Feed of IDs deleted or removed from Spot2. With `since` parameter.

API key (header)

Automatic validation of each property. Those that pass are published.

Result via webhook

POST/api/webhooks/spot2/feedback

Optional webhook for publication or rejection notifications.

Property schema·Property lifecycle·Examples·Security

Where to start

Three paths depending on what you need.

Quickstart

Step-by-step guide to integrate your CRM in minutes.

Property Schema

The complete reference of fields, types, and validations.

Examples

Concrete request and response cases with real data.