Embedding your listings

Drop a live, filtered map of your own organization's listings straight into your own website -- no login required for visitors, and no separate integration to build.

Before you start

  • Turn on "Allow public organization filter" in your organization's settings -- without it, visitors to your embedded map see a private/blocked page instead of your listings.
  • Set your own subdomain (also in settings) -- this is what the embed URL is built from.
  • Available to real organizations only -- a personal (sandbox) workspace's own subdomain can't be embedded elsewhere.
  • Register the exact domain(s) you'll embed from in the same Embed section -- with none registered, embedding is blocked everywhere by default (a direct browser visit to your own subdomain still works either way).

Getting your embed code

Once both are set, your organization's settings page shows a ready-to-copy snippet built from your own subdomain -- something like this:

<iframe src="https://yourcompany.chaochaoth.com/search" width="100%" height="600" style="border:0" loading="lazy"></iframe>

Paste it anywhere on your own site's HTML. Resize by changing width/height.

Configuring what shows

Add query parameters to the embed URL to pre-filter what visitors see by default -- no code, just extend the src like src=".../search?listingType=rent&propertyType=condo&maxPrice=30000". Anything you don't set falls back to the ordinary defaults (Rent, Condo, no other filters).

<iframe src="https://yourcompany.chaochaoth.com/search?listingType=rent&propertyType=condo&maxPrice=30000" width="100%" height="600" style="border:0" loading="lazy"></iframe>
ParameterValuesDescription
listingTyperent | sellWhich tab to show. Defaults to rent.
propertyTypecondo, apartment, house, townhouse, warehouse, commercial_house, stall, retail_space, office, land, otherDefaults to condo -- there's no "all types" view.
minPrice, maxPricenumberPrice range, in Thai baht -- applies to whichever side listingType is showing (rent_price or sell_price).
minArea, maxAreanumberArea range, in square meters.
bedroomsnumberAt least this many bedrooms (a floor, not an exact match).
bathroomsnumberAt least this many bathrooms (a floor, not an exact match).
landColoryellow, orange, red, purple, light-green, green, pink, blue, otherThailand's city-planning land-use zoning color -- only meaningful for warehouse/land listings.
amenitiescomma-separated keysComma-separated amenity keys (e.g. allow_pets,gas,water_included) -- only listings with every one listed match. See your own listing editor's amenity picker for the full list.
q, place_idtextFree-text search or a Google Place ID -- either centers the initial map view.
lat, lng, zoomnumberInitial map center/zoom -- an alternative to q/place_id if you already know the coordinates you want.
sortrecommended, price_desc, price_asc, distance_asc, updated_descResult order. "recommended" (the default) is a per-tile cached ordering, not a true global sort -- any other value always queries live instead.

What shows up

Exactly what a visitor to your own subdomain would see -- your organization's own listings, filtered the same way, with your own branding if you've set any. Nothing from any other organization ever appears.