{"openapi":"3.1.0","info":{"title":"Anh Nguyen Real Estate public listings","version":"1.1.0","description":"Anonymous read-only inventory. Public portal listings are current and available. Occupancy is separate from sale/rental availability. Follow nextCursor for all matching listings."},"servers":[{"url":"https://anhnguyenrealty.com"}],"paths":{"/api/listings":{"$ref":"#/paths/~1api~1v1~1listings"},"/api/v1/listings":{"get":{"operationId":"searchListings","summary":"Search current public listings","parameters":[{"name":"city","in":"query","description":"City name or canonical city ID, e.g. ho-chi-minh-city","schema":{"type":"string"}},{"name":"district","in":"query","description":"Familiar search district, e.g. district-7, District 7 or 7; not a replacement for current administrative address","schema":{"type":"string"}},{"name":"neighborhood","in":"query","description":"Neighborhood name or ID, e.g. phu-my-hung","schema":{"type":"string"}},{"name":"status","in":"query","description":"Current public inventory only","schema":{"type":"string","enum":["active"]}},{"name":"transactionType","in":"query","description":"Alias of purpose","schema":{"type":"string","enum":["rent","sale"]}},{"name":"minArea","in":"query","description":"Alias of minSize","schema":{"type":"number","minimum":0}},{"name":"maxArea","in":"query","description":"Alias of maxSize","schema":{"type":"number","minimum":0}},{"name":"propertyType","in":"query","description":"Alias of category","schema":{"type":"string"}},{"name":"project","in":"query","description":"Alias of projectId","schema":{"type":"string"}},{"name":"purpose","in":"query","description":"Transaction type","schema":{"type":"string","enum":["rent","sale"]}},{"name":"category","in":"query","description":"Property type","schema":{"type":"string","enum":["apartment","villa","townhouse","villa townhouse","room","commercial"]}},{"name":"areaId","in":"query","description":"Published area ID from /api/v1/areas","schema":{"type":"string"}},{"name":"projectId","in":"query","description":"Project ID from /api/v1/projects","schema":{"type":"string"}},{"name":"projectIds","in":"query","description":"Comma-separated project IDs; maximum 100","schema":{"type":"string"}},{"name":"keyword","in":"query","description":"Property or building text; a whole catalog area/project name resolves geographically","schema":{"type":"string"}},{"name":"bedrooms","in":"query","description":"Room count","schema":{"type":"number","minimum":0}},{"name":"minBedrooms","in":"query","description":"Room count","schema":{"type":"number","minimum":0}},{"name":"bathrooms","in":"query","description":"Room count","schema":{"type":"number","minimum":0}},{"name":"minBathrooms","in":"query","description":"Room count","schema":{"type":"number","minimum":0}},{"name":"minSize","in":"query","description":"Floor area in square metres","schema":{"type":"number","minimum":0}},{"name":"maxSize","in":"query","description":"Floor area in square metres","schema":{"type":"number","minimum":0}},{"name":"minPrice","in":"query","description":"Budget in the comparison currency","schema":{"type":"number","minimum":0}},{"name":"maxPrice","in":"query","description":"Budget in the comparison currency","schema":{"type":"number","minimum":0}},{"name":"currency","in":"query","description":"Budget/comparison currency. Cross-currency comparison uses the disclosed indicative 26000 VND/USD portal setting, with no live quotation date.","schema":{"type":"string","enum":["VND","USD"]}},{"name":"pricePeriod","in":"query","description":"Monthly rent or total sale price","schema":{"type":"string","enum":["month","total"]}},{"name":"featured","in":"query","schema":{"type":"boolean"}},{"name":"sort","in":"query","description":"Deterministic ordering","schema":{"type":"string","enum":["newest","oldest","price_asc","price_desc","featured"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","description":"Opaque nextCursor from the preceding response; restart on 409","schema":{"type":"string"}}],"responses":{"200":{"description":"items, appliedFilters, totalMatches, complete, hasMore, nextCursor, generatedAt, comparison. complete is true only on the last page.","content":{"application/json":{"schema":{"type":"object","required":["items","hasMore","complete","totalMatches","nextCursor"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Listing"}},"hasMore":{"type":"boolean"},"complete":{"type":"boolean"},"totalMatches":{"type":"integer"},"nextCursor":{"type":["string","null"]}}}}}},"400":{"description":"Unsupported or invalid criteria"},"409":{"description":"Inventory/filters changed; restart pagination"},"429":{"description":"Rate limited; obey Retry-After"},"503":{"description":"Inventory unavailable; no partial results"}}}},"/api/v1/listings/{id}":{"get":{"operationId":"getListing","summary":"Get public listing facts","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"listing and generatedAt","content":{"application/json":{"schema":{"type":"object","properties":{"listing":{"$ref":"#/components/schemas/Listing"},"generatedAt":{"type":"string","format":"date-time"}}}}}},"404":{"description":"No current public listing with this ID"},"503":{"description":"Inventory unavailable"}}}},"/api/v1/areas":{"get":{"operationId":"listAreas","summary":"List published areas and project membership","responses":{"200":{"description":"areas and generatedAt"}}}},"/api/v1/projects":{"get":{"operationId":"listProjects","summary":"List canonical projects","responses":{"200":{"description":"projects and generatedAt"}}}}},"components":{"schemas":{"Listing":{"type":"object","required":["id","url","title","price","availability","lastVerifiedAt"],"properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"purpose":{"enum":["rent","sale",null]},"category":{"type":["string","null"]},"price":{"type":"object","properties":{"amount":{"type":["number","null"]},"currency":{"enum":["VND","USD",null]},"period":{"enum":["month","total",null]}}},"canonicalUrl":{"type":"string","format":"uri"},"slug":{"type":["string","null"]},"transactionType":{"enum":["rent","sale",null]},"propertyType":{"type":["string","null"]},"areaSqm":{"type":["number","null"]},"priceVnd":{"type":["number","null"],"description":"Original VND price; null for USD listings. Use price and disclosed comparison rate for conversion."},"pricePeriod":{"enum":["month","total",null]},"projectId":{"type":["string","null"]},"projectName":{"type":["string","null"]},"projectSlug":{"type":["string","null"]},"images":{"type":"array","items":{"type":"string","format":"uri"}},"furnished":{"type":"null"},"furnishing":{"type":"null"},"floor":{"type":"null"},"availableFrom":{"type":"null"},"propertySizeM2":{"type":["number","null"]},"bedrooms":{"type":["number","null"]},"bathrooms":{"type":["number","null"]},"availability":{"const":"available"},"status":{"const":"active"},"availabilitySource":{"const":"published_portal_inventory"},"city":{"type":"string"},"district":{"type":"string"},"neighborhood":{"type":"string"},"occupancy":{"const":"unknown"},"lastVerifiedAt":{"type":"null"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"contact":{"type":"object"}}}}}}