{"openapi":"3.1.0","info":{"title":"AL SAEB Public Real Estate Discovery API","version":"1.2.0","description":"Read-only project discovery. Prices are project starting figures in original currency, and the buyer authorizes any reservation on AL SAEB."},"servers":[{"url":"https://alsaeb.com"}],"paths":{"/ai/search":{"get":{"operationId":"searchAlSaebProjects","summary":"Search public AL SAEB property projects","description":"Filter by city, country, developer, type and original-currency price. Currency required with min_price or max_price.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"location","in":"query","required":false,"schema":{"type":"string"}},{"name":"developer","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"}},{"name":"min_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Published project results","content":{"application/json":{"schema":{"type":"object","properties":{"published_catalogue_total":{"type":"integer"},"total":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"developer":{"type":"string"},"location":{"type":"string"},"country":{"type":["string","null"]},"city":{"type":["string","null"]},"type":{"type":"string"},"starting_price":{"type":["number","null"],"description":"Published project starting price only"},"original_currency":{"type":["string","null"]},"property_url":{"type":"string","format":"uri"},"attributed_property_url":{"type":"string","format":"uri","description":"Optional first-party tagged link used for measuring AI referral leads; original property_url stays canonical"},"reserve_url":{"type":"string","format":"uri"},"payment_terms":{"type":"null"},"unit_level":{"type":"boolean"}}}}}}}}},"400":{"description":"Invalid filter"},"502":{"description":"Source temporarily unavailable"}}}},"/ai/project":{"get":{"operationId":"getAlSaebProject","summary":"Get published AL SAEB project details","description":"Read-only. Includes source property URL; never confirms specific-unit availability or accepts payment.","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","pattern":"^project_[a-f0-9]{24,32}$"}}],"responses":{"200":{"description":"Published project","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"unit_availability_confirmed":{"type":"boolean"},"price_type":{"type":"string"},"project":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"developer":{"type":"string"},"location":{"type":"string"},"country":{"type":["string","null"]},"city":{"type":["string","null"]},"type":{"type":"string"},"starting_price":{"type":["number","null"],"description":"Published project starting price only"},"original_currency":{"type":["string","null"]},"property_url":{"type":"string","format":"uri"},"attributed_property_url":{"type":"string","format":"uri","description":"Optional first-party tagged link used for measuring AI referral leads; original property_url stays canonical"},"reserve_url":{"type":"string","format":"uri"},"payment_terms":{"type":"null"},"unit_level":{"type":"boolean"}}}}}}}},"400":{"description":"Invalid ID"},"404":{"description":"Project not found"},"502":{"description":"Source temporarily unavailable"}}}}}}