API Documentation

Complete API reference for integrating unified marketplace data across all 9 platforms

Quick Start Guide

1. Get Your API Key

curl -X POST https://api.marketplace.com/v1/auth/keys \
-H "Content-Type: application/json"

2. Make Your First Request

Fetch listings from the marketplace.

curl -X GET https://api.marketplace.com/v1/listings \
-H "Authorization: Bearer YOUR_API_KEY"

3. Sync Data

Set up webhooks to stay synchronized with real-time updates.

POST /v1/webhooks \
event_types: ['listing.created', 'listing.updated']

Core API Endpoints

GET

/v1/listings

Retrieve all property listings with advanced filtering

GET

/v1/listings/:id

Get details for a specific listing

POST

/v1/listings

Create a new property listing

PUT

/v1/listings/:id

Update an existing listing

DELETE

/v1/listings/:id

Delete a property listing

GET

/v1/users/:id

Get user profile and preferences

GET

/v1/agents

List all agents across platforms

Data Models

Listing Object

{
  "id": "listing_123",
  "title": "Luxury Apartment",
  "address": "123 Main St",
  "city": "New York",
  "price": 450000,
  "bedrooms": 3,
  "bathrooms": 2,
  "sqft": 1500,
  "type": "apartment",
  "status": "active",
  "agent_id": "agent_456",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-08-21T15:45:00Z"
}

User Object

{
  "id": "user_789",
  "email": "user@example.com",
  "name": "John Doe",
  "role": "buyer",
  "phone": "+1234567890",
  "preferences": {
    "radius": 25,
    "price_min": 100000,
    "price_max": 500000,
    "bedrooms": 3
  },
  "created_at": "2026-01-01T00:00:00Z",
  "platform": "exit_realty"
}

Authentication

The API uses Bearer token authentication. Include your API key in the Authorization header:

Authorization: Bearer your_api_key_here

API keys are unique to your account. Keep them secure and never expose them in client-side code.

Rate Limits & Pricing

Free Tier

Requests: 1,000/month

Rate: 10/minute

Support: Email

Popular

Professional

Requests: 50,000/month

Rate: 500/minute

Support: Priority

Enterprise

Requests: Unlimited

Rate: Custom

Support: Dedicated