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.

We only accept these 4 canonical property_type families:

• office
• retail
• industrial
• terrain

If your CRM uses internal subtypes (for example buildings, warehouses, industrial buildings, or shopping center units), normalize them to one of these 4 values before exposing the feed.

---

How it works

Spot2 queries your API on scheduled cycles (typically every hour):

1. Property feed — GET /properties?updated_since=.... Your CRM returns active listings explicitly selected by the user for Spot2 and modified since that date.
2. Deletion feed — GET /properties/deleted?since=.... Your CRM returns the IDs of delisted properties.
3. We validate each property against the QA rules (BLOCK, DRAFT, WARN severities; WARN only applies to missing amenities).
4. We publish the ones that pass on the Spot2 marketplace.
5. We notify acceptance or rejection via the Ingestion 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 active listings selected for Spot2 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 processing acceptance and rejection notifications with natural-language messages.

---

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, Bearer Token, TLS.
• QA Rules: quality rules and their messages.
• Integration Examples: concrete use cases.
• Changelog: contract changes.