GET/search

Search accommodations

Search accommodations by location and optional stay dates; returns properties with price, star class, review score and distance.

Bearer auth. Pass your key as Authorization: Bearer <key> on every request.

Parameters

location

stringRequiredin query

Destination free-text (city, region, landmark). Alias: ss, q.

checkin

stringOptionalin query

Check-in date YYYY-MM-DD (pair with checkout; pricing only appears with dates)

checkout

stringOptionalin query

Check-out date YYYY-MM-DD

adults

integerOptionalin query

Number of adults

children

integerOptionalin query

Number of children (default age 10 each)

rooms

integerOptionalin query

Number of rooms

page

integerOptionalin query

Source result page (1-based; each page ~25 properties, maps to Booking offset (page-1)*25)

limit

integerOptionalin query

Max items to return from the page

offset

integerOptionalin query

Offset within the returned page

refresh

booleanOptionalin query

Bypass and repopulate the cache

Response fields

dataobject

cachedboolean

sourcestring

paginationobject

curl "https://api.maviapi.com/v1/sites/booking/search?location=Amsterdam&checkin=2026-09-10&checkout=2026-09-12&adults=2&children=0&rooms=1&page=1&limit=5&offset=0&refresh=false" \

-H "Authorization: Bearer $MAVI_KEY"

{ "data": { "location": "Amsterdam", "checkin": "2026-09-10", "checkout": "2026-09-12", "adults": 2, "children": 0, "rooms": 1, "page": 1, "total": 349, "count": 5, "results": [ { "name": "MAX Hotel Amsterdam", "hotel_id": "nl/hotelmaxadam", "country": "nl", "hotel_slug": "hotelmaxadam", "url": "https://www.booking.com/hotel/nl/hotelmaxadam.html", "price": "€ 219", "price_amount": 219, "currency": "€", "stars": 2, "review_score": 6.6, "review_label": "Very Good", "review_count": 1606, "distance": "1.8 km from downtown", "image": "https://cf.bstatic.com/xdata/images/hotel/square240/864090609.webp" } ] }, "cached": false, "source": "https://www.booking.com/searchresults.html?ss=Amsterdam&checkin=2026-09-10&checkout=2026-09-12", "pagination": { "total": 25, "limit": 5, "offset": 0, "count": 5, "has_more": true } }

Booking.com

Search accommodations

Parameters

Response fields

Get all the data, no code