Overview
Spot2 Ingestion is the service that connects your CRM to the Spot2 commercial real estate marketplace. We query your API, validate your data, and publish properties that meet our quality standards.
Who this is for
CRM, real estate portal, MLS, or broker platform that wants to publish commercial properties on Spot2. Residential properties are not published.
Property types we accept:
- Offices
- Retail spaces
- Warehouses and industrial buildings
- Commercial and industrial land
- Full buildings
- Shopping center units
How it works
Spot2 queries your API on scheduled cycles (typically every hour):
- Property feed —
GET /properties?updated_since=.... Your CRM returns active properties modified since that date. - Deletion feed —
GET /properties/deleted?since=.... Your CRM returns the IDs of delisted properties. - We validate each property against the QA rules (severities BLOCK, DRAFT, WARN).
- We publish the ones that pass on the Spot2 marketplace.
- We notify you of the results via webhook (if configured).
Without the deletion endpoint, properties delisted in your CRM will remain published. The entire process is automatic once integrated.
What you need to build
| # | Deliverable | Required | Purpose |
|---|---|---|---|
| 1 | GET /properties endpoint with updated_since | Yes | Expose your active properties as JSON, filtered by modification date. |
| 2 | GET /properties/deleted endpoint with since | Yes | Report IDs of deleted properties since a given date. |
| 3 | POST /webhooks/spot2/feedback endpoint | No | Receive publication and rejection notifications (messages in natural language). |
Reference docs
- Quickstart: step-by-step guide.
- Property Schema: all fields, types, and validations.
- Sync Protocol: your properties endpoint contract.
- Safety Guards: empty feed and mass deletion protections.
- Partial Deletion: how to handle modality changes.
- Feedback Webhook: how to receive notifications.
- Lifecycle: what happens to a property over time.
- Deletion Protocol: deletion endpoint contract.
- Security: authentication, HMAC, TLS.
- QA Rules: quality rules and their messages.
- Examples: concrete use cases.
- Changelog: contract changes.