Uhuu Real Estate Standard

Version: v0.1.0 (draft)

This standard defines the canonical property listing payload used by Uhuu templates and integrations. It is based on Schema.org RealEstateListing, plus Offer and Residence/Place modeling for property details.

Schema JSON

Open schema JSON (v0.1.0): Uhuu Real Estate Standard

Extensibility

The schema is strict (additionalProperties: false) to keep payloads consistent. Use the extensions object for vendor- or client-specific fields that are not part of the standard.

Examples

Real-World Example

{
  "@context": "https://schema.org",
  "@type": "RealEstateListing",
  "id": "uhuu-2c0b7a1a-5b3e-4c0f-9a2e-5e9a9c1b2c3d",
  "externalId": "CH-ZH-2025-000879",
  "sourceSystem": "PartnerFeed",
  "listingStatus": "active",
  "listingType": "forSale",
  "name": "Modern 3-bedroom apartment near Lake Zurich",
  "slug": "modern-3br-apartment-near-lake-zurich",
  "description": "Bright 3-bedroom apartment near Lake Zurich with open-plan living, balcony, and premium finishes.",
  "language": "en",
  "createdAt": "2025-01-18T09:10:00Z",
  "updatedAt": "2025-01-28T15:30:00Z",
  "publishedAt": "2025-01-20T08:00:00Z",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Seefeldstrasse 88",
    "addressLocality": "Zurich",
    "addressRegion": "ZH",
    "postalCode": "8008",
    "addressCountry": "CH",
    "unitNumber": "4B"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 47.3569,
    "longitude": 8.5484
  },
  "property": {
    "@type": "Apartment",
    "propertyCategory": "residential",
    "propertySubType": "apartment",
    "yearBuilt": 2016,
    "bedrooms": 3,
    "bathroomsTotal": 2,
    "roomsTotal": 4,
    "floorNumber": "4",
    "unitNumber": "4B",
    "furnished": "furnished",
    "condition": "excellent"
  },
  "floorArea": {
    "@type": "QuantitativeValue",
    "value": 128,
    "unitText": "m2",
    "unitCode": "MTK"
  },
  "offer": {
    "@type": "Offer",
    "price": 1950000,
    "priceCurrency": "CHF",
    "pricePeriod": "oneTime",
    "availability": "InStock",
    "validFrom": "2025-01-20T08:00:00Z",
    "deposit": {
      "value": 150000,
      "currency": "CHF"
    },
    "fees": [
      {
        "name": "HOA",
        "type": "association",
        "amount": { "value": 520, "currency": "CHF" },
        "period": "perMonth"
      }
    ],
    "includedUtilities": [],
    "isNegotiable": true
  },
  "images": [
    {
      "@type": "ImageObject",
      "contentUrl": "https://cdn.example.com/images/listings/zh-4b/hero.jpg",
      "position": 0,
      "caption": "Bright living room with balcony",
      "width": 1920,
      "height": 1080,
      "category": "livingRoom"
    },
    {
      "@type": "ImageObject",
      "contentUrl": "https://cdn.example.com/images/listings/zh-4b/kitchen.jpg",
      "position": 1,
      "caption": "Open-plan kitchen",
      "category": "kitchen"
    }
  ],
  "listingAgents": [
    {
      "@type": "Person",
      "id": "agent-118",
      "name": "Anna Keller",
      "email": "anna.keller@uhuu-realestate.ch",
      "telephone": "+41-44-555-0101",
      "jobTitle": "Listing Advisor",
      "licenseNumber": "ZH 118-2025",
      "contactPoint": {
        "@type": "ContactPoint",
        "name": "Anna Keller",
        "telephone": "+41-44-555-0101",
        "availableLanguage": ["de", "en"],
        "contactType": "sales"
      }
    }
  ],
  "listingOffice": {
    "@type": "Organization",
    "id": "office-zh-01",
    "name": "Uhuu Zurich",
    "email": "zurich@uhuu-realestate.ch",
    "telephone": "+41-44-555-0202",
    "url": "https://uhuu-realestate.ch",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "Badenerstrasse 120",
      "addressLocality": "Zurich",
      "addressRegion": "ZH",
      "addressCountry": "CH"
    }
  },
  "amenities": [
    "Balcony",
    "Elevator",
    "Underfloor Heating",
    "Basement Storage"
  ],
  "labels": ["lakeView", "central", "familyFriendly", "furnished"],
  "parking": {
    "spaces": 1,
    "type": "underground",
    "description": "One reserved parking spot"
  },
  "url": "https://uhuu.app/listings/modern-3br-apartment-near-lake-zurich",
  "metadata": {
    "integrationSource": "partner_feed",
    "lastSync": "2025-01-28T15:30:00Z"
  }
}