Hotel data API with Airbnb, Zillow and flight data
Hotel prices and review scores from Booking.com, Airbnb stays, Tripadvisor places, Zillow homes and Google Flights fares, as JSON for your app or agent.
Rate shopping, rental market research, trip-planning agents and property screening all start with the same thing: current listings with prices, for a place and dates you choose. Lovely Router returns them as JSON from Booking.com, Airbnb, Tripadvisor, Zillow and Google Flights: a hotel data API and a real estate data API on one key. You pay per hotel, listing or place returned, from one prepaid balance, and call the tools from your code or let an AI agent call them over MCP.
Hand it to your AI agent
Copy this prompt into Claude Code, Cursor, Codex or any coding agent. It tells the agent where the docs are and how to use your API key.
Get hotel prices and review scores from Booking.com, Airbnb stays, Tripadvisor places, Zillow homes and Google Flights fares. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <the destinations, dates, budget and what to compare>How it works
Pick a place and dates
A destination for hotels, an Airbnb search URL with dates, a city for Tripadvisor, ZIP codes for Zillow, a route for flights.
Run the tool with a cap
Send the input to
POST /v1/tools/{id}/runwithmax_results. The run holds its maximum cost and settles to the results it returned.Compare and repeat
Store prices with the date you collected them, then rerun on a schedule to follow rates, rents or fares over time.
Get hotel prices with one request
Booking.com hotels searches a destination for your dates and returns each hotel with the price for the stay. This run asks for 20 hotels in Lisbon for five nights, two adults, priced in euros:
curl https://lovelyrouter.com/v1/tools/booking-hotels/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"search": "Lisbon",
"checkin": "2026-11-09",
"checkout": "2026-11-14",
"adults": 2,
"currency": "EUR"
},
"max_results": 20
}'Each hotel in items has its name, price for the stay, review score, stars, address and whether it offers free cancellation. Leave checkin empty and the tool prices one night, 30 days from now. A run still going after 60 seconds returns 202; Run a tool shows how to poll.
The tools
Hotels on Booking.com for a destination (and dates): name, price for the stay, review score, stars, address, free cancellation.
Guest reviews of Booking.com hotels: score, likes, dislikes, traveler type, date.
Airbnb listings for a place and dates: price for the stay and per night, rating, reviews, host, amenities, house rules, photos.
Tripadvisor hotels, restaurants and attractions for a location.
Zillow homes for sale, for rent or recently sold in ZIP codes: price, beds, baths, living area, address, Zestimate.
Flight options and prices from Google Flights for a route and dates: airlines, times, stops, duration, price.
| Tool | You send | Each result holds |
|---|---|---|
booking-hotels | search, checkin, checkout, adults, currency | Name, price for the stay, review score, stars, address, free cancellation |
booking-reviews | startUrls of hotels, sortReviewsBy, reviewScores | Score, likes, dislikes, traveler type, date |
airbnb-listings | urls: Airbnb search URLs with dates (a place name works too) | Price for the stay and per night, rating, reviews, host, amenities, house rules, photos |
tripadvisor-places | query (a location or keyword), includeHotels, includeRestaurants | A hotel, restaurant or attraction for the location |
zillow-listings | locations (ZIP codes), operation (buy, rent or sold), minPrice, maxPrice | Price, beds, baths, living area, address, Zestimate |
google-flights | searches: origin, destination, dates (IATA codes), plus adults, cabinClass, maxStops | Airlines, times, stops, duration, price |
Recipes
Run booking-hotels every morning for your city and the dates you sell, and track the price for the stay of the hotels in your competitive set. Add booking-reviews with "sortReviewsBy": "f_recent_desc" to see what their guests like and dislike this month.
Run airbnb-listings with https://www.airbnb.com/s/Lisbon/homes?checkin=2026-11-09&checkout=2026-11-14&adults=2 and compare per-night prices and ratings with Booking.com hotels for the same dates.
Run zillow-listings for ZIP code 78701 three times, with operation set to buy, rent and sold, and compare asking prices, recent sale prices and rents per living area. Zestimate comes with each home.
Price flights with google-flights and "searches": [{"origin": "LAX", "destination": "JFK", "departureDate": "2026-11-04", "returnDate": "2026-11-09"}], then find hotels for the same dates with booking-hotels and things to do with tripadvisor-places.
Run tripadvisor-places with "query": "Chicago" and "includeRestaurants": true to list hotels, restaurants and attractions, then pull reviews for the ones you feature with Tripadvisor reviews.
An agent connected to the MCP server does the same from one prompt in Claude Code or Cursor: "Find round-trip flights from LAX to JFK leaving November 4 and returning November 9, and the five best-rated hotels in Midtown under 300 dollars a night for those dates. Show both as tables and set max_results on every run."
What you pay
Each tool bills per result: a hotel, a listing, a place, a review or a flight search, plus a per-call fee on the tools that have one; the cards above show today's prices. Starting a run holds its maximum cost, per-call fee plus per-result fee times max_results, and settles to what it returned. A run that fails or times out pays only for results it delivered, and a run refused at the start costs nothing.
There's no subscription and no minimum term. Top up from $5, and the same balance pays for model calls if an agent or your code summarizes the results. See pricing for every tool.
Frequently asked questions
Does the hotel data include prices for my dates?+
Yes. The booking-hotels tool takes check-in and check-out dates and the number of adults, and returns the price for that stay. Without a check-in date it prices one night, 30 days from now.
Which currencies can I get hotel prices in?+
The booking-hotels tool takes a currency, such as USD, EUR, GBP, JPY, CNY or AUD, from a list of 20. Google Flights takes any three-letter currency code for its prices.
Can I get Zillow rentals and recently sold homes, not just homes for sale?+
Yes. Set operation to rent or sold instead of buy. For rentals, minPrice and maxPrice are per week.
How do I search Airbnb for specific dates?+
Pass an Airbnb search URL with the dates and guests in it, such as /s/Lisbon/homes?checkin=…&checkout=…&adults=2. A plain place name works too. Each listing comes back with the price for the stay and per night.
Can I book a hotel or flight through the API?+
No. These tools read public listings and prices; they don't make bookings. For a web task that needs clicks and forms, see the browser agent.
Is real estate data available outside the US?+
The Zillow tool searches by US ZIP code. For stays elsewhere, Booking.com, Airbnb and Tripadvisor search by place name, so any city or region you can name on those sites works.
For guest reviews across more sites, see review monitoring, and for agents that combine these tools with web search, see research agents.