Build your own websiteAPI referenceStays search
Search published listings by place, dates, guests and map viewport
Query Parameters
jurisdiction?string
Matched case-insensitively.
checkIn?string
First night. Requires checkOut.
Format
date-timecheckOut?string
Departure morning — exclusive. Requires checkIn.
Format
date-timeguests?number
type?string
Value in
- "APARTMENT"
- "VILLA"
- "CHALET"
- "ISTRAHA"
- "FARM"
- "ROOM"
- "BED"
- "OFFICE"
- "OTHER"
north?number
south?number
east?number
west?number
page?number
perPage?number
Capped at 50.
Header Parameters
X-Site*string
The site key identifying which website this request belongs to. May be omitted only when the request comes from a domain already verified for the site (the Origin/Host then resolves it), or when the deprecated X-Subdomain header is used.
X-Api-Key?string
Publishable (pk_…) or secret (sk_…) key for this site. Required on writes; accepted on reads. NOTE: currently rolling out in monitor mode — a write without a valid key is logged rather than refused, so this is documented as optional. It becomes required on writes when enforcement is switched on; send it now.
Response Body
curl -X GET "https://example.com/api/public/stays/search" \ -H "X-Site: string"Empty