Wunderprop API Documentation

wp_sandbox_test123
wp_sandbox_myapp_dev
wp_test_integration
wp_test_local

{
  "id": 12345,
  "sandbox": true,
  "message": "Lead validated successfully. In production, this would be saved to the database.",
  "lead": {
    "sellerName": "Test Seller",
    "propertyType": "haus",
    "propertyAddress": "Test St 1, Hamburg",
    "id": 12345,
    "status": "neu",
    "source": "public_api_sandbox",
    "createdAt": "2024-01-01T00:00:00.000Z"
  }
}

{
  "id": 789
}

curl https://wunderprop.io/api/public/v1/industry-types \
  -H "X-API-Key: wp_your_api_key_here"

// Response
{
  "apiKeyMasked": "wp_***...***abc",
  "isEnabled": true
}

{
  "ok": true
}

[
  {
    "id": 1,
    "name": "Immobilienmakler"
  },
  {
    "id": 2,
    "name": "Fotograf"
  },
  {
    "id": 3,
    "name": "Gutachter"
  }
]

{
  "email": "partner@example.com",
  "companyName": "Muster GmbH",
  "firstName": "Max",
  "lastName": "Mustermann",
  "service": "Immobilienmakler",
  "phone": "+49 123 456789",
  "city": "Hamburg"
}

{
  "success": true
}

{
  "sellerName": "Erika Musterfrau",
  "sellerPhone": "+49 987 654321",
  "sellerEmail": "erika@example.com",
  "propertyType": "haus",
  "propertyAddress": "Beispielstraße 1, 20095 Hamburg",
  "estimatedPrice": 350000,
  "description": "Renovierungsbedürftig",
  "marketingType": "verkauf"
}

{
  "id": 42
}

[
  {
    "id": 123,
    "title": "Schöne 3-Zimmer Wohnung",
    "address": "Hamburg, Eimsbüttel",
    "price": 450000,
    "rooms": 3,
    "livingSpace": 85,
    "propertyType": "wohnung"
  }
]

?city=Hamburg&industryType=Fotograf&status=active

{
  "propertyIds": [123, 456, 789],
  "pipeline": "sales"
}

{
  "id": 42,
  "companyName": "Foto Plus GmbH",
  "industryType": "Fotograf",
  "city": "Hamburg",
  "contactPerson": "Max Mustermann",
  "email": "max@fotoplus.de",
  "phone": "+49 123 456789",
  "website": "https://fotoplus.de",
  "status": "active"
}

[
  {
    "id": 1,
    "tipId": 123,
    "amount": 1500.00,
    "currency": "EUR",
    "status": "paid",
    "paidAt": "2024-01-15T10:00:00Z",
    "propertyAddress": "Hauptstraße 1, Hamburg"
  }
]

// Step 1: Start with sandbox for development and testing
const SANDBOX_BASE = 'https://wunderprop.io/api/sandbox/v1';
const SANDBOX_KEY = 'wp_sandbox_test123'; // Any key starting with wp_sandbox_ or wp_test_

// Step 2: Test your integration in sandbox
async function testInSandbox() {
  const response = await fetch(`${SANDBOX_BASE}/leads`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': SANDBOX_KEY
    },
    body: JSON.stringify({
      sellerName: 'Test Seller',
      propertyType: 'haus',
      propertyAddress: 'Test Street 1, Hamburg'
    })
  });
  
  const result = await response.json();
  console.log('Sandbox test:', result);
  // Output includes: { sandbox: true, message: "...", ... }
}

// Step 3: Once testing is complete, switch to production
const PROD_BASE = 'https://wunderprop.io/api/public/v1';
const PROD_KEY = process.env.WUNDERPROP_API_KEY; // Real API key from admin dashboard

async function createLead(leadData) {
  const response = await fetch(`${PROD_BASE}/leads`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': PROD_KEY
    },
    body: JSON.stringify(leadData)
  });
  
  if (!response.ok) {
    const error = await response.json();
    throw new Error(`API Error: ${error.error}`);
  }
  
  return await response.json();
}

// Using fetch API with environment-based configuration
const IS_PRODUCTION = process.env.NODE_ENV === 'production';
const API_BASE = IS_PRODUCTION 
  ? 'https://wunderprop.io/api/public/v1'
  : 'https://wunderprop.io/api/sandbox/v1';
const API_KEY = IS_PRODUCTION
  ? process.env.WUNDERPROP_API_KEY
  : 'wp_sandbox_local_dev';

async function invitePartner(partnerData) {
  const response = await fetch(`${API_BASE}/partners/invite`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': API_KEY
    },
    body: JSON.stringify(partnerData)
  });
  
  if (!response.ok) {
    const error = await response.json();
    throw new Error(`API Error: ${error.error}`);
  }
  
  return await response.json();
}

// Usage
const partner = {
  email: 'max@example.com',
  companyName: 'Max Immobilien GmbH',
  firstName: 'Max',
  lastName: 'Mustermann',
  service: 'Immobilienmakler',
  phone: '+49 123 456789',
  city: 'Hamburg'
};

try {
  const result = await invitePartner(partner);
  if (result.sandbox) {
    console.log('✓ Sandbox test successful:', result.message);
  } else {
    console.log('Partner invited successfully');
  }
} catch (error) {
  console.error('Error:', error.message);
}

import os
import requests

# Use sandbox for testing, production for live
IS_PRODUCTION = os.environ.get('ENV') == 'production'
API_BASE = (
    'https://wunderprop.io/api/public/v1' if IS_PRODUCTION 
    else 'https://wunderprop.io/api/sandbox/v1'
)
API_KEY = (
    os.environ.get('WUNDERPROP_API_KEY') if IS_PRODUCTION
    else 'wp_sandbox_python_test'
)

def submit_lead(lead_data):
    """Submit a property lead"""
    headers = {
        'Content-Type': 'application/json',
        'X-API-Key': API_KEY
    }
    
    response = requests.post(
        f'{API_BASE}/leads',
        json=lead_data,
        headers=headers
    )
    
    response.raise_for_status()
    result = response.json()
    
    if result.get('sandbox'):
        print(f"✓ Sandbox test: {result.get('message')}")
    
    return result

# Usage
lead = {
    'sellerName': 'Erika Musterfrau',
    'sellerPhone': '+49 987 654321',
    'sellerEmail': 'erika@example.com',
    'propertyType': 'haus',
    'propertyAddress': 'Beispielstraße 1, 20095 Hamburg',
    'estimatedPrice': 350000,
    'description': 'Renovierungsbedürftig'
}

try:
    result = submit_lead(lead)
    print(f"Lead created with ID: {result['id']}")
except requests.exceptions.RequestException as e:
    print(f"Error: {e}")

// Authenticated Makler API - Build automated property monitoring
const API_BASE = 'https://wunderprop.io/api';
const authToken = 'your-session-token'; // From login

// Complete workflow: Monitor properties and manage favorites
async function automatedPropertyMonitoring() {
  // Step 1: Create search criteria
  const criteria = await fetch(`${API_BASE}/search-criteria`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Cookie': `session=${authToken}`
    },
    body: JSON.stringify({
      name: "Hamburg Waterfront Properties",
      city: "Hamburg",
      minPrice: 500000,
      maxPrice: 1500000,
      propertyType: "wohnung",
      minRooms: 3,
      isActive: true
    })
  }).then(r => r.json());
  
  // Step 2: Get matching properties
  const properties = await fetch(`${API_BASE}/properties`, {
    headers: { 'Cookie': `session=${authToken}` }
  }).then(r => r.json());
  
  // Step 3: Process each property
  for (const property of properties) {
    if (property.price < 800000 && property.rooms >= 3) {
      // Add to favorites
      await fetch(`${API_BASE}/favorites/${property.id}`, {
        method: 'POST',
        headers: { 'Cookie': `session=${authToken}` }
      });
      
      // Mark as prospect
      await fetch(`${API_BASE}/properties/${property.id}/prospect`, {
        method: 'PATCH',
        headers: {
          'Content-Type': 'application/json',
          'Cookie': `session=${authToken}`
        },
        body: JSON.stringify({ isProspect: true })
      });
    }
  }
}

// Partner API - Complete service management workflow
const API_BASE = 'https://wunderprop.io/api';
const sessionToken = 'partner-session-token';

async function managePartnerBusiness() {
  // Get dashboard overview
  const [profile, stats, tips, orders] = await Promise.all([
    fetch(`${API_BASE}/partner/current`, {
      headers: { 'Cookie': `session=${sessionToken}` }
    }).then(r => r.json()),
    fetch(`${API_BASE}/partner/stats`, {
      headers: { 'Cookie': `session=${sessionToken}` }
    }).then(r => r.json()),
    fetch(`${API_BASE}/partner/property-tips`, {
      headers: { 'Cookie': `session=${sessionToken}` }
    }).then(r => r.json()),
    fetch(`${API_BASE}/marketplace/partner/orders`, {
      headers: { 'Cookie': `session=${sessionToken}` }
    }).then(r => r.json())
  ]);
  
  console.log(`Partner: ${profile.companyName}`);
  console.log(`Open tips: ${tips.length}`);
  console.log(`Pending orders: ${orders.filter(o => o.status === 'pending').length}`);
  
  // Create marketplace listing
  const listing = await fetch(`${API_BASE}/marketplace/partner/listings`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Cookie': `session=${sessionToken}`
    },
    body: JSON.stringify({
      serviceId: 3,
      title: "Premium Photography Package",
      description: "Professional photos + 3D tour",
      basePrice: 499.00,
      currency: "EUR",
      turnaroundDays: 3
    })
  }).then(r => r.json());
  
  // Process orders
  for (const order of orders.filter(o => o.status === 'pending')) {
    await fetch(`${API_BASE}/marketplace/partner/orders/${order.id}/status`, {
      method: 'PATCH',
      headers: {
        'Content-Type': 'application/json',
        'Cookie': `session=${sessionToken}`
      },
      body: JSON.stringify({
        status: 'in_progress',
        notes: 'Started working on order'
      })
    });
  }
}

curl https://wunderprop.io/api/sandbox/v1/health

curl -X POST https://wunderprop.io/api/sandbox/v1/partners/invite \
  -H "Content-Type: application/json" \
  -H "X-API-Key: wp_sandbox_test123" \
  -d '{
    "email": "partner@example.com",
    "companyName": "Muster GmbH",
    "firstName": "Max",
    "service": "Immobilienmakler"
  }'

curl -X POST https://wunderprop.io/api/sandbox/v1/leads \
  -H "Content-Type: application/json" \
  -H "X-API-Key: wp_sandbox_test123" \
  -d '{
    "sellerName": "Erika Musterfrau",
    "propertyType": "haus",
    "propertyAddress": "Beispielstraße 1, 20095 Hamburg",
    "estimatedPrice": 350000
  }'

{
  "error": "Invalid payload",
  "details": {
    "email": ["Invalid email address"],
    "companyName": ["Required field"]
  }
}

{
  "error": "Missing API key"
}

// or

{
  "error": "Invalid API key"
}

{
  "error": "Rate limit exceeded"
}

{
  "error": "Internal server error"
}