Use case · Market scans

Market scans: what hotels in a city charge for your dates.

Pick a destination and dates. See the median price, the cheapest and the priciest stay, and the full list of hotels sorted by price.

API · FOR YOUR OWN TOOLS

City prices in your own tools.

Search a city for your dates and get the hotels it returns, each with its live price, rating and star class. Load the results into your own product, dashboard or BI tool. Explore the API →

  • Get each hotel's price, rating and star class
  • See free cancellation and sold-out flags
  • Start with 50 free requests, no card
GET /v1/booking/search
200 OK
{
  "success": true,
  "data": {
    "hotels": [
      {
        "hotel_id": "4045490",
        "name": "Maxime Boutique Hotel Avenida da Liberdade",
        "city": "Lisboa",
        "star_rating": 3,
        "price": {
          "currency": "USD",
          "display": "$376",
          "before_discount": "$470"
        },
        "rating": {
          "score": 8.8,
          "review_count": 3617
        },
        "free_cancellation": true,
        "is_sold_out": false
      },
      {
        "hotel_id": "10131840",
        "name": "MASA Hotel & Spa Campo Grande Collection",
        "city": "Lisboa",
        "star_rating": 4,
        "price": {
          "currency": "USD",
          "display": "$258",
          "before_discount": "$323"
        },
        "rating": {
          "score": 8.5,
          "review_count": 11888
        },
        "free_cancellation": true,
        "is_sold_out": false
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 2
    }
  }
}

Trusted by teams at

What you get

The market for one destination and one stay.

  • 01
    PRICE LEVEL

    The going rate for the night.

    The median price per night, with the cheapest and the priciest stay in the results.

  • 02
    LIST

    Every hotel in the results, by price.

    Each hotel with its star class, guest score, number of reviews, price per night and total for the stay.

  • 03
    AVAILABILITY

    What is still on sale.

    How many of the hotels in the results show a live price for your dates.

  • 04
    DATES

    Any dates, any party size.

    Scan a weekend, an event week or a season, for the number of guests and rooms you set.

What you can build

What you can build with market data.

Examples built on StayAPI data. Use them as they are or build your own.

See how prices spread across a city.

Group the hotels in a city by price per night for your dates. You see the median and where most of the market sits.

Price distribution

Lisbon · Feb 13–15 · 2 adults · Booking.com · hotels by price per night

Example
Hotels
50
Range
€30 – €189
Median
€86
  • 5 €30–49
  • 9 €50–69
  • 12 €70–89
  • 11 €90–109
  • 6 €110–129
  • 4 €130–149
  • 2 €150–169
  • 1 €170–189

Find the best value in each star class.

Sort a city's hotels by star class and price, with their guest rating. You see the cheapest good option at each level.

Best value by star class

Lisbon · Feb 13–15 · 4-star hotels, cheapest first, with guest rating

Example
2★ · 7 hotels
from €30
3★ · 17 hotels
from €48
4★ · 21 hotels
from €85
5★ · 5 hotels
from €141
Hotel Per night Rating
MASA Hotel & Spa Campo Grande €85 8.5
The Cloud One Lisbon €94 9.0
Docas Hotel Lisbon €101 9.6

See which nights fill up first.

Check the share of hotels with a room left for each night ahead. The tight nights stand out before you set your rates.

Availability by date

Lisbon · share of the 50 hotels with a room for 2 adults, per night

Example
Average
82%
Tightest
Sat Mar 6 · 59%
Feb 13 73% 14 88% 15 90% 16 88% 17 90% 18 92% 19 76% 20 75% 21 92% 22 90% 23 87% 24 89% 25 84% 26 74% 27 72% 28 89% Mar 1 92% 2 85% 3 87% 4 88% 5 74% 6 59% 7 73% 8 79% 9 79% 10 85% 11 89% 12 71% 13 76% 14 86%

Ask for hotels that fit a budget.

Connect StayAPI to Claude or ChatGPT and ask about a city's hotels in plain language. The answer comes back as a table you can keep working on.

Ask your AI

Example

Which 4-star hotels in Lisbon are under €100 a night for Feb 13–15?

CallingUsed StayAPI · booking_search_hotels

Two 4-star hotels in the scan are under €100 a night on Booking.com:

HotelPer nightRating
MASA Hotel & Spa Campo Grande€858.5
The Cloud One Lisbon€949.0

Docas Hotel Lisbon is just above, at €101, and has the best rating of the three (9.6).

Reply…
Coverage

What’s available, by source.

The data you can get from each booking site and hotel brand, live on every request.

Source Search Rates Rooms Reviews Details Photos Mapping
Booking.com Yes Yes Yes Yes Yes Yes Yes
Expedia Yes Yes No Yes Yes No Yes
Agoda Yes Yes No Yes Yes No Yes
Google Hotels Yes Yes Yes Yes Yes Yes Yes
TripAdvisor Yes Yes No Yes Yes No Yes
Airbnb Yes Yes No Yes Yes Yes Yes
Trip.com Yes No No Yes No No No
Marriott Bonvoy Yes Yes Yes No No No No
Hilton Yes No Yes No No No Yes
Accor Yes Yes Yes Yes Yes Yes Yes
Ctrip Yes No Yes Yes Yes No Yes
Google Maps Yes No No No Yes No No
Google Reviews No No No Yes No No No
HolidayCheck Yes No No Yes Yes No Yes
IHG Yes No Yes No No No Yes
KAYAK Yes Yes No Yes Yes Yes Yes
MakeMyTrip Yes No No Yes Yes No No
OpenTable Yes Yes No Yes Yes No Yes
Otelpuan Yes No Yes Yes No No Yes
Radisson Yes Yes Yes Yes Yes Yes Yes
Vrbo Yes No No Yes No No Yes
WeHotel (Jin Jiang) Yes No Yes Yes Yes No Yes
Wyndham Yes No Yes No No No Yes

This table may be behind. The docs have the latest list of sources. All sources in the docs

Related

What goes with market scans.

Use case

Comp set tracking

Your price next to the hotels you compete with, for the same night.

Learn more about comp set tracking
Use case

Rate shopping

Live prices for any hotel and dates, from every booking site at once.

Learn more about rate shopping
Use case

Hotel content

Details, photos, room types and amenities for any property.

Learn more about hotel content
Use case

Rate parity

Where the same room is cheaper than your own website, and by how much.

Learn more about rate parity
Use case

Hotel matching

The same hotel's IDs on Booking, Expedia, Agoda, Google and more.

Learn more about hotel matching
Use case

Review monitoring

The latest reviews and scores from Booking, Google, TripAdvisor, Agoda and more, in one feed.

Learn more about review monitoring
Questions

Frequently asked questions

Does a scan cover every hotel in the city?

No. A scan reads the search results a traveler would see for the destination and dates, so it is a sample of the market. Through the API you can page further into the results.

Where do the prices come from?

The Market Rate Scan report reads live Booking.com search results. Through the API you can run the same kind of search on other sources. See the docs.

Can I narrow the scan?

Yes. Set the number of guests and rooms, and a minimum star class.

Can I scan the same market every week?

Yes. Schedule the report daily, weekly or monthly and get it by email. Each run is saved, and a new run shows what changed since the previous one. Stay dates roll forward with the schedule.

Are the prices live?

Yes. Every scan goes to the source when you run it. Saved scans show when they were pulled.

Pick the path that fits.

Start on your own, or talk to us first.

01 · building something?

Start free

Sign up and get live data in about a minute: API, AI assistant, Hotel Database or Reports. Fifty free requests, no card.

Start free
02 · buying a solution?

Book a call

Fifteen minutes. We look at your hotels and your use case, and show you live data on them. Pricing on the call.

Book a call