{"openapi":"3.1.0","info":{"title":"HouseMe.ai — Paige for AI agents","version":"1.0.0","description":"Zero-auth real-estate answers from live MLS data. Coverage: Ontario, Canada (Toronto/GTA) and the Mid-Atlantic US (DC, Maryland, Virginia and neighbors). Ask in natural language; get Markdown or JSON with listings, a conversation_id for follow-ups, and a continue_url your user can open to keep chatting with Paige. Never submit a user's contact details without their explicit consent. Typical latency 3-12s, up to ~40s on heavy follow-ups — use a 45s+ timeout and retry the same URL once on failure (conversation state persists). Rate limit 30 req/min/IP.","termsOfService":"https://m.houseme.ai/terms-of-service","contact":{"email":"dev@houseme.ai","url":"https://m.houseme.ai/for-ai-agents"}},"servers":[{"url":"https://m.houseme.ai"}],"paths":{"/ask":{"get":{"operationId":"askPaige","summary":"Ask a real-estate question in natural language","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"The question, plain English."},{"name":"market","in":"query","schema":{"type":"string","enum":["ca","us"]},"description":"ca = Ontario/Toronto (default), us = DC/Maryland/Virginia."},{"name":"c","in":"query","schema":{"type":"string"},"description":"conversation_id from a prior response — continues the thread with full context."},{"name":"format","in":"query","schema":{"type":"string","enum":["md","json"]},"description":"Markdown (default) or JSON."}],"responses":{"200":{"description":"Paige's answer. Markdown (text/markdown) by default; JSON when format=json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskResponse"}},"text/markdown":{"schema":{"type":"string"}}}},"429":{"description":"Rate limited (30 req/min/IP)."}}}},"/ask/{slug}":{"get":{"operationId":"askPaigeBySlug","summary":"Same as /ask, question in the URL path (survives query-string-stripping fetch tools)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"The question as a slug: 2-bed-condo-toronto-under-650k"}],"responses":{"200":{"description":"Markdown answer.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/ask/c/{cid}/{slug}":{"get":{"operationId":"askPaigeFollowUp","summary":"Path-borne follow-up on an existing conversation","parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string"},"description":"conversation_id from a prior response."},{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"The follow-up question as a slug."}],"responses":{"200":{"description":"Markdown answer with full conversation context.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"AskResponse":{"type":"object","properties":{"reply":{"type":"string","description":"Paige's answer."},"listings":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"city":{"type":"string"},"price":{"type":"number"},"beds":{"type":"number"},"baths":{"type":"number"},"status":{"type":"string"},"url":{"type":"string","description":"Human-viewable listing page."}}}},"conversation_id":{"type":"string"},"continue_url":{"type":"string","description":"Share with your user — opens the live Paige chat with full history."}}}}}}