8.2 KiB

Raw Blame History

Travel APIs — Airbnb, Booking, Google Flights

Endpoint	Returns
`/scrape/airbnb/listing`	Airbnb search results
`/scrape/airbnb/property`	Single Airbnb listing
`/scrape/booking/search`	Booking.com search results (hotels, apartments)
`/scrape/booking/place`	Single Booking.com property with room/rate list
`/scrape/google/flights`	Google Flights prices and itineraries

All synchronous GET. Airbnb is 5 credits; Booking is 10; Google Flights is 15.

For activities at the destination see /scrape/google/events (in search.md); for ground transport, scrape the operator's site with POST /scrape/web.

Airbnb

import requests

def airbnb_search(location, check_in, check_out, **kwargs):
    return requests.get(
        "https://api.hasdata.com/scrape/airbnb/listing",
        headers={"x-api-key": API_KEY},
        params={"location": location, "checkIn": check_in, "checkOut": check_out, **kwargs},
        timeout=300,
    ).json()

Param	Notes
`location`	Required. Free-form.
`checkIn`	Required. `YYYY-MM-DD`.
`checkOut`, `adults`, `children`, `infants`, `pets`	Optional.
`nextPageToken`	Pagination cursor.

Token pagination

def airbnb_all(location, check_in, check_out):
    out, token = [], None
    while True:
        page = airbnb_search(location, check_in, check_out,
                             **({"nextPageToken": token} if token else {}))
        out.extend(page.get("listings", []))
        token = page.get("nextPageToken")
        if not token:
            return out

Airbnb Property

requests.get(
    "https://api.hasdata.com/scrape/airbnb/property",
    headers={"x-api-key": API_KEY},
    params={"url": "https://www.airbnb.com/rooms/12345678"},
    timeout=300,
)

Booking Search

import json, requests

def booking_search(keyword, check_in, check_out, *, adults=2, children=0,
                   children_ages=None, rooms=1, **filters):
    params = {
        "keyword":      keyword,
        "checkInDate":  check_in,
        "checkOutDate": check_out,
        "adults":       adults,
        "children":     children,
        "rooms":        rooms,
        **filters,
    }
    if children and children_ages:
        params["childrenAgesJson"] = json.dumps(children_ages)
    return requests.get(
        "https://api.hasdata.com/scrape/booking/search",
        headers={"x-api-key": API_KEY},
        params=params, timeout=300,
    ).json()

Param	Notes
`keyword`	Required. City, neighborhood, or property name.
`checkInDate` / `checkOutDate`	Required. `YYYY-MM-DD`.
`adults`, `children`, `rooms`	Required. Pass `children=0` explicitly when none.
`childrenAgesJson`	Required iff `children > 0` — JSON array of ages (0–17), one per child.
`price[min]` / `price[max]`	`>= 10` / `>= 20`. Bracketed — `requests`/`axios` serialize nested dicts as `price[min]=…`.
`rating[]`, `reviewScore[]`, `propertyType[]`, `facilities[]`, `meals[]`, `bedPreference[]`, `roomFacilities[]`, `propertyAccessibility[]`, `roomAccessibility[]`, `distanceFromCenter[]`, `travelGroup[]`, `onlinePayment[]`, `reservationPolicy[]`	Multi-value filters (OR).
`bedrooms`, `bathrooms`	Minimum count.
`sort`	`ourTopPicks`, `homesAndApartmentsFirst`, `priceLowestFirst`, `priceHighestFirst`, `bestReviewedAndLowestPrice`, `ratingHighToLow`, `ratingLowToHigh`, `ratingAndPrice`, `distanceFromDowntown`, `topReviewed`.
`page`	1-indexed, 25 results per page.
`currency`	ISO code or `hotelCurrency` to keep native.
`language`	UI locale.

Top-level response (verified live): requestMetadata, searchInformation, pagination, results. Per-result keys: hotelId, roomId, title, url, location, rating, reviews, price (object with total / nightly / currency), room, beds, bedTypes, policies, photo.

Booking Place

resp = requests.get(
    "https://api.hasdata.com/scrape/booking/place",
    headers={"x-api-key": API_KEY},
    params={
        "url":           "https://www.booking.com/hotel/fr/le-bristol-paris.html",
        "checkInDate":   "2026-07-10",
        "checkOutDate":  "2026-07-13",
        "adults":         2,
        "children":       0,
        "rooms":          1,
    },
    timeout=300,
).json()

url must be booking.com / www.booking.com. The remaining stay/guest parameters share the same rules as booking-search (including childrenAgesJson when children > 0).

Response top-level keys: requestMetadata, overview, bookingDetails, rooms, facilities, houseRules, ratings, reviews, restaurants, breadcrumbs, questionsAndAnswers.

overview → id, title, address, description, propertyType, photos, highlights, mostPopularFacilities.
rooms[i] → roomId, name, bedTypes, beds, facilities, otherFacilities, variants[] (per-rate price/availability). Variants are the actual buyable units; rooms[i] is the floor-plan.

Google Flights

resp = requests.get(
    "https://api.hasdata.com/scrape/google/flights",
    headers={"x-api-key": API_KEY},
    params={
        "departureId":  "JFK",
        "arrivalId":    "LAX",
        "outboundDate": "2026-06-15",
        "returnDate":   "2026-06-22",     # omit for one-way
        "currency":     "USD",
    },
    timeout=300,
).json()

Param	Notes
`departureId` / `arrivalId`	Required. IATA airport codes (`JFK`, `LAX`).
`outboundDate`	Required. `YYYY-MM-DD`.
`returnDate`	Optional — omit for one-way.
`currency`	ISO code.
`gl`, `hl`	Country / language.
`travelClass`	`1` economy, `2` premium economy, `3` business, `4` first.
`stops`	`0` any, `1` non-stop, `2` ≤1 stop, `3` ≤2 stops.
`adults`, `children`, `infantsInSeat`, `infantsOnLap`	Passenger counts.

Patterns

STR yield estimate

rentals = airbnb_search(area, ci, co).get("listings", [])           # Airbnb → "listings"
# pair with /scrape/zillow/listing (see real-estate.md) for purchase price
night   = sum(r.get("price", 0) for r in rentals) / max(len(rentals), 1)

Hotel-vs-rental price diff

b = booking_search(city, ci, co, adults=2, children=0, rooms=1, sort="priceLowestFirst")
a = airbnb_search(city, ci, co, adults=2)
def median(xs): xs = sorted(xs); return xs[len(xs)//2] if xs else None
median_hotel = median([r["price"]["nightly"] for r in b.get("results", []) if r.get("price")])
median_str   = median([r["price"]            for r in a.get("listings", []) if r.get("price")])

Full trip cost

flight = requests.get(
    "https://api.hasdata.com/scrape/google/flights",
    headers={"x-api-key": API_KEY},
    params={"departureId": origin, "arrivalId": dest_iata,
            "outboundDate": dep, "returnDate": ret, "currency": "USD"},
    timeout=300,
).json()
cheapest_flight = min((f["price"] for f in flight.get("best_flights", [])), default=None)

stay = booking_search(city, dep, ret, adults=2, children=0, rooms=1, sort="priceLowestFirst")
cheapest_stay = stay.get("results", [{}])[0].get("price", {}).get("total")

total = (cheapest_flight or 0) + (cheapest_stay or 0)

Gotchas

Airbnb requires checkIn and uses token pagination — store nextPageToken, not page numbers.
Airbnb property endpoints take URLs, not IDs.
Booking requires children even when zero. Pass children=0. When children > 0, also pass childrenAgesJson with exactly that many ages.
Booking price[min] / price[max] are bracketed — use a nested dict with requests/axios.
Booking rooms[i].variants[] is where prices live — the parent rooms[i] describes the floor-plan, variants are the buyable rates with priceBreakdown / cancellationPolicy / mealPlan.
bookingDetails carries the resolved stay context the response was priced for — echo it back when persisting results so future comparisons use the same dates / occupancy.
Google Flights uses IATA codes, not city names. JFK not New York.
Round-trip vs one-way is determined by returnDate presence — pass it for round-trip, omit for one-way.

8.2 KiB Raw Blame History Unescape Escape