Visual Property Search for Real Estate Platforms

import { Mixpeek } from 'mixpeek';

const client = new Mixpeek({ apiKey: process.env.MIXPEEK_API_KEY });

// Process property listing photos
await client.buckets.connect({
  collection_id: 'property-listings',
  bucket_uri: 's3://listings/photos/',
  extractors: [
    'image-embedding',       // Visual similarity
    'object-detection',      // Rooms, features, amenities
    'scene-classification',  // Interior style, condition
    'image-captioning'       // Natural language descriptions
  ],
  settings: {
    property_features: [
      'kitchen_style', 'bathroom_type', 'flooring',
      'view', 'pool', 'fireplace', 'garage', 'backyard',
      'architectural_style', 'condition', 'natural_light'
    ],
    generate_descriptions: true
  }
});

// Visual similarity search
async function searchByImage(imageUrl: string, filters?: PropertyFilters) {
  const results = await client.retrieve({
    collection_id: 'property-listings',
    query: {
      type: 'image',
      url: imageUrl  // Buyer uploads photo of dream kitchen
    },
    filters: {
      price: { $lte: filters?.maxPrice },
      bedrooms: { $gte: filters?.minBeds },
      location: { $within: filters?.geoRadius }
    },
    return_fields: [
      'listing_id', 'photos', 'price', 'address',
      'detected_features', 'similarity_score'
    ],
    limit: 50
  });

  return results.map(r => ({
    ...r,
    matching_features: r.detected_features.filter(
      f => f.confidence > 0.8
    )
  }));
}

// Search by natural language description
async function searchByDescription(query: string, filters?: PropertyFilters) {
  // e.g., "modern kitchen with white cabinets and island"
  // e.g., "craftsman home with original details"

  const results = await client.retrieve({
    collection_id: 'property-listings',
    query: {
      type: 'text',
      text: query
    },
    filters: {
      price: { $lte: filters?.maxPrice },
      status: 'active'
    },
    return_fields: [
      'listing_id', 'photos', 'price', 'address',
      'detected_features', 'ai_description'
    ],
    limit: 50
  });

  return results;
}

// Track buyer preferences from interactions
async function trackBuyerPreference(buyerId: string, listingId: string, action: 'save' | 'view' | 'contact') {
  const listing = await client.collections.get(listingId);

  await client.users.updatePreferences({
    user_id: buyerId,
    positive_signals: action === 'save' ? listing.detected_features : [],
    view_history: [listingId],
    weight: action === 'save' ? 1.0 : 0.3
  });
}

// Get personalized recommendations
async function getRecommendations(buyerId: string) {
  const prefs = await client.users.getPreferences(buyerId);

  return client.retrieve({
    collection_id: 'property-listings',
    query: {
      type: 'preferences',
      user_id: buyerId
    },
    filters: {
      status: 'active',
      listing_id: { $nin: prefs.viewed_listings }
    },
    limit: 20
  });
}