# Choosing a hotel price API: 10 questions to ask before you buy

> A buyer's checklist for hotel price and rate-shopping APIs: sources, tax and fee handling, booking window, markets, stay rules, freshness, failure billing and cost per night priced.

Canonical page: https://scrapercompany.com/research/choosing-a-hotel-price-api. Guide by ScraperCompany, published 9 November 2026.

Hotel price data looks simple: a hotel, a date and a number. In practice, two APIs can return different "prices" for the same room-night, and both can be right. One includes tax and the other doesn't, one is the cheapest seller and the other is the hotel's own site, or one is for a US visitor and the other for a UK one.

Whether you're building a rate-shopping tool, a travel app, a parity monitor or an AI travel agent, these ten questions will tell you more about a hotel price API than its homepage will. Each one includes a reason it matters, drawn from real prices we collected in November 2026.

## 1. Which sources does it cover, and which price is "the price"?

A hotel's price exists in several places: the hotel's own website, the big online travel agencies (Booking.com, Expedia, Agoda, Hotels.com), smaller resellers, and metasearch sites like Google Hotels that list all of them.

**Ask:** does the API return *every* seller for a stay, or one headline number? If one number, which seller is it?

**Why it matters:** for one night at the Palmer House Hilton in Chicago, we saw 20 sellers between $173.00 and $264.24, a 53% spread for the same room-night. "The price" depends entirely on which one you pick.

## 2. Does it include the hotel's own website?

For rate parity, direct-booking analysis and revenue management, the hotel's own booking-engine price is the reference point. Many data sources only cover booking sites.

**Ask:** can it read prices straight from a hotel's own website, and how many booking-engine platforms does it support?

## 3. How does it handle taxes and fees?

This causes more bad comparisons than anything else. US sites usually show prices before tax, while European sites usually include VAT. Many hotels add mandatory fees that are listed separately.

**Ask:** does every price come with the base rate, taxes, fees and total kept separate? Is it clear which of these the seller actually itemised and which the API estimated?

**Why it matters:** at the Bellagio in Las Vegas, a $55 mandatory fee was **38% of the total** on the cheapest night of the season. An API that drops fees understates the real price by a third.

## 4. How far ahead can it price, and in how many calls?

Revenue managers look three to twelve months ahead. Pricing one night per call quickly gets slow and expensive.

**Ask:** what's the longest booking window per hotel, and can a whole calendar come back in one request?

**Why it matters:** the most expensive night of the season at two of the four hotels we tracked was a Monday in late January, not New Year's Eve. You only find nights like that with a full forward calendar ([see the data](https://scrapercompany.com/research/new-years-eve-hotel-prices-2026)).

## 5. Does it return stay rules?

Minimum stays, closed-to-arrival dates and length-of-stay pricing change what a guest actually pays.

**Ask:** does the response say when a night needs a minimum stay or can't be booked?

**Why it matters:** in London, New Year's Eve at Park Plaza Westminster Bridge needed a two-night minimum. Its real cost was about $1,514, not the $1,097.52 one-night price.

## 6. Which markets and currencies can you request?

Prices differ by the visitor's country, in currency, tax display and sometimes the rate itself.

**Ask:** can you set the market (point of sale) and the currency separately? How many markets are supported?

## 7. How fresh is the data, and does it tell you when it was collected?

Hotel prices change many times a day. Cached data from yesterday can be wrong today.

**Ask:** is each price fetched live or served from a cache? Does every price carry a timestamp?

## 8. What happens when a request fails?

Every source fails sometimes: blocks, timeouts, sold-out hotels, dates outside the booking window.

**Ask:** are failed and empty requests billed? Does the API say *why* a night has no price (sold out, outside the booking window or an error)?

**Why it matters:** for one Tuesday night in December we found a major New York hotel with no prices at all. You don't want to pay for that, and you need to know the difference between "sold out" and "broken".

## 9. What does one *night* cost, not one *call*?

Pricing pages list a cost per request, but a "request" can mean one night or a whole year.

**Ask:** what does it cost to price one hotel for 90 nights? For 365? For a comp set of 10 hotels, every day, for a month?

Work it out for your real workload before comparing headline prices.

## 10. Can your AI agents use it directly?

More teams now query travel data through AI assistants and agents.

**Ask:** is there an MCP server or tool definitions, so assistants such as Claude, ChatGPT or Cursor can call the API without custom glue code?

## A one-page checklist

| Question | What good looks like |
|---|---|
| Sources | Every seller on the property page, plus the hotel's own site |
| Direct rates | Reads the hotel's own booking engine |
| Taxes and fees | Base, tax, fees and total kept separate, with provenance |
| Booking window | 300+ nights per hotel in one call |
| Stay rules | Minimum stays and unavailable nights flagged |
| Markets | Market and currency set independently |
| Freshness | Live fetch, timestamp on every price |
| Failures | Failed and empty requests free, with a reason |
| Cost | Clear price per hotel-calendar, not just per request |
| AI agents | MCP server and OpenAPI spec |

## How ScraperCompany answers these questions

We built ScraperCompany's hotel APIs around this checklist, so here are our own answers:

- **Sources:** every seller Google Hotels lists for a stay, plus Booking.com, Expedia, Hotels.com, Agoda, Airbnb and Vrbo directly, and hotels' own websites through the [Hotel Direct Rates API](https://scrapercompany.com/hotel-direct-rates-api) (over 50 booking engines, with more added regularly).
- **Taxes and fees:** base rate, taxes, fees and total kept separate, with provenance showing when and how each price was observed.
- **Booking window:** up to 330 nights per hotel in one [Google Hotels API](https://scrapercompany.com/google-hotels-api) calendar call.
- **Failures:** failed requests (4xx or 5xx) and empty result pages cost 0 credits.
- **Cost:** a fixed, published credit cost per endpoint. There's a free trial of 50 calls or 14 days, whichever ends first, no card needed, and paid plans start at $49/month for 40,000 credits. See [pricing](https://scrapercompany.com/pricing).
- **AI agents:** an [MCP server](https://scrapercompany.com/docs/mcp) and an [OpenAPI spec](https://scrapercompany.com/openapi.json).

Whichever API you choose, run the same test stay through each candidate and compare the raw responses side by side. It's the fastest way to see which questions each one actually answers.

## FAQ

**What is a hotel price API?**
A hotel price API returns hotel room prices as structured data (usually JSON) for a given hotel, dates and number of guests. Sources can include the hotel's own website, online travel agencies and metasearch sites such as Google Hotels.

**What is hotel rate shopping?**
Rate shopping is collecting competitors' room prices, usually for every night over the next months, to set your own prices. Hotels and revenue managers use rate-shopping tools or APIs to automate it.

**Why do two hotel APIs return different prices for the same night?**
Usually because they differ on tax and fee inclusion, the seller (cheapest seller or hotel website), the visitor's market and currency, the room and rate type, or when the price was collected.

**How many nights ahead can hotel prices be collected?**
It depends on the hotel's booking window, which is often about 11 months to a year. ScraperCompany's Google Hotels calendar returns up to 330 nights per hotel in one call.

## Read next

- [Is booking a hotel direct cheaper? We priced 8 hotels across 20+ booking sites](https://scrapercompany.com/research/is-booking-direct-cheaper.md)
- [New Year's Eve hotel prices: up to 5.8x a normal December night, except in Chicago](https://scrapercompany.com/research/new-years-eve-hotel-prices-2026.md)
- [How to check hotel rate parity: a practical guide for 2026](https://scrapercompany.com/research/how-to-check-hotel-rate-parity.md)
- [What's new at ScraperCompany: autumn 2026 product update](https://scrapercompany.com/news/product-update-autumn-2026.md)
