# o-waw

> o-waw is an AI-friendly real estate platform providing a public, structured API for searching properties and projects across Bangkok, Thailand. All endpoints are unauthenticated, JSON-based, and designed for programmatic access by AI agents and developers.

## Quick Start

Base URL: https://api.o-waw.com

All endpoints return JSON. No authentication required. No rate limits for reasonable use.

### Property Search

GET https://api.o-waw.com/llm/properties

Query parameters:
- status: "rent" or "sale"
- type: property type(s) — condo, house, townhouse, commercial, land, other (repeat for multiple)
- minPrice / maxPrice: price range in THB
- minArea / maxArea: area range in sqm
- minBedrooms / minBathrooms: minimum room counts
- lat, lng, radius: geographic search (radius in km, max 100)
- projectId: filter to a specific project
- search: full-text search across address and description
- limit: max results per page (1-100, default 20)
- skip: pagination offset (default 0)

Response: { properties: [...], total: number, hasMore: boolean }

Each property includes: id, type, status, price (THB), pricePerSqm, area (sqm), bedrooms, bathrooms, address, loc ([lng, lat]), images (full CDN URLs), projectName, projectId, description, createdAt, updatedAt.

Example: https://api.o-waw.com/llm/properties?status=rent&type=condo&minPrice=10000&maxPrice=30000&limit=5

### Property Detail

GET https://api.o-waw.com/llm/properties/{id}

Returns full property data plus floorNumber, petFriendly, marketPrice, updatedAt.

Example: https://api.o-waw.com/llm/properties/WN7qXXtSCiHD0Lm_o-hPFQ

### Project Search

GET https://api.o-waw.com/llm/projects

Query parameters:
- type: project type(s) — condo, house, townhouse, commercial, land, other
- search: full-text search across name and description
- lat, lng, radius: geographic search (radius in km)
- minYearBuilt / maxYearBuilt: year built range
- limit / skip: pagination (same as properties)

Response: { projects: [...], total: number, hasMore: boolean }

Each project includes: id, name, type, loc, address, district, city, province, images (full CDN URLs), developer, yearBuilt, totalUnits, totalFloors, description, createdAt.

Example: https://api.o-waw.com/llm/projects?type=condo&search=sukhumvit&limit=5

### Project Detail

GET https://api.o-waw.com/llm/projects/{id}

Returns full project data plus activeListingCount (number of active listings in this project).

Example: https://api.o-waw.com/llm/projects/eNaAq7762Cd9mDwvFKZL6Q

## Property Types

- condo: Condominium units (most common)
- house: Detached or semi-detached houses
- townhouse: Row houses / townhomes
- commercial: Commercial spaces, shops, offices
- land: Vacant land plots
- other: Miscellaneous property types

## Listing Status

- rent: Properties available for rent (prices in THB/month)
- sale: Properties available for purchase (prices in THB)

## Response Format

All responses are JSON. Lists include total count and hasMore for pagination. Images are served as full URLs from CDN (https://images.o-waw.com). Coordinates are [longitude, latitude] (GeoJSON order). Timestamps are milliseconds since epoch.

Errors return: { success: false, error: string, message?: string }

## Data Coverage

- 37,602 active property listings (rent and sale)
- 2,660 real estate projects and condominiums
- Primarily Bangkok metropolitan area, Thailand
- All prices in Thai Baht (THB)

## AI Agent Discovery Standards

This API supports multiple discovery mechanisms:

- API Catalog (RFC 9727): https://api.o-waw.com/.well-known/api-catalog
- MCP Server Card (SEP-1649): https://api.o-waw.com/.well-known/mcp/server-card.json
- Agent Skills Index (v0.2.0): https://api.o-waw.com/.well-known/agent-skills/index.json
- OpenAPI/Swagger Docs: https://api.o-waw.com/api/docs
- Health Check: https://api.o-waw.com/health

## Website

https://o-waw.com

The website provides an interactive map-based property search with MapLibre GL, filterable listings, and detail views. It is a PWA (Progressive Web App) with multilingual support (English, Thai, Chinese, Japanese, Korean, and 10+ more languages).