{
  "updated": "June 23, 2026",
  "publisher": "Real Estate Agent AI Index Research Desk",
  "name": "Consumer Shortlist Request Intake Schema",
  "description": "Public schema for a consumer shortlist request workflow. The workflow is designed to help buyers and sellers clarify agent-selection criteria without changing ranking placement.",
  "ranking_boundary": "Ranking placement cannot be purchased. Submitting a shortlist request does not change public rankings, scores, badges, category placement, or editorial coverage.",
  "privacy_boundary": "Collect only the information needed to build an interview list. Do not collect Social Security numbers, bank credentials, loan documents, legal disputes, or private financial files through the shortlist workflow.",
  "commercial_boundary": "Any future referral or introduction product must stay separate from ranking methodology and must disclose commercial relationships where required.",
  "fields": [
    {
      "field": "consumer_role",
      "label": "Buying, selling, or both",
      "purpose": "Route the consumer toward buyer-specific, seller-specific, or dual-purpose proof signals.",
      "examples": [
        "Selling",
        "Buying",
        "Buying and selling"
      ],
      "sensitive": false
    },
    {
      "field": "target_market",
      "label": "Target market or neighborhood",
      "purpose": "Match the request to the most relevant live market page, planned market, or neighborhood context.",
      "examples": [
        "Chicago North Shore",
        "Los Angeles Westside",
        "Brooklyn"
      ],
      "sensitive": false
    },
    {
      "field": "price_band",
      "label": "Approximate price band",
      "purpose": "Separate luxury, move-up, first-time, investment, and specialty-property use cases without collecting financial documents.",
      "examples": [
        "Under $750k",
        "$750k-$1.5M",
        "$1.5M+"
      ],
      "sensitive": false
    },
    {
      "field": "property_type",
      "label": "Property type",
      "purpose": "Identify whether the consumer needs proof around condos, co-ops, single-family homes, estates, investment property, or new construction.",
      "examples": [
        "Single-family",
        "Condo",
        "Co-op",
        "Luxury estate",
        "Investment"
      ],
      "sensitive": false
    },
    {
      "field": "timeline",
      "label": "Decision timeline",
      "purpose": "Help distinguish urgent representation needs from early research.",
      "examples": [
        "Now",
        "30-90 days",
        "3-6 months",
        "Exploring"
      ],
      "sensitive": false
    },
    {
      "field": "representation_preference",
      "label": "Team, individual, or no preference",
      "purpose": "Let the consumer choose the operating model that fits their communication and service expectations.",
      "examples": [
        "Team",
        "Individual",
        "No preference"
      ],
      "sensitive": false
    },
    {
      "field": "proof_priorities",
      "label": "What proof matters most",
      "purpose": "Weight the shortlist toward production, reviews, AI visibility, local expertise, listing marketing, buyer access, or luxury specialization.",
      "examples": [
        "Sales production",
        "Reviews",
        "AI visibility",
        "Off-market network",
        "Listing marketing"
      ],
      "sensitive": false
    },
    {
      "field": "contact_permission",
      "label": "Permission to follow up",
      "purpose": "Future lead capture must be permission-based and separate from ranking placement.",
      "examples": [
        "Research only",
        "Contact me about my shortlist"
      ],
      "sensitive": true
    }
  ]
}