HomeToGo Scraper

Scrape vacation rental listings from HomeToGo — the world's largest vacation rental metasearch engine, aggregating millions of offers from Vrbo, Booking.com, Airbnb-style providers, and more. Search any destination and get prices, images, property type, size, amenities, geo-coordinates, and direct booking links. No auth, no cookies, no paid proxy required.

What this actor does

• Three modes: search (destination text → offers), searchByLocationId (skip resolution, use a known ID directly), autocomplete (destination lookup only)
• Global coverage: any city, region, or landmark HomeToGo indexes worldwide
• Rich filters: dates, guest count, price range, property type, amenities, size, sort order
• Real per-offer data: actual amenities and prices as returned by HomeToGo for the requested search — no filler/placeholder listings included
• Empty fields are omitted

Output per rental offer

• offerId, rentalObjectId
• title, propertyType, propertyTypeLabel, sizeSqm
• priceDisplay, priceAmount, priceCurrency, priceType
• locationLabel, searchLocationId
• latitude, longitude
• images (thumbnail/small/medium/large), imageUrl, imageAltText
• amenities[] — {code, label} pairs, e.g. pool, internet, pets_allowed
• nearby — true if HomeToGo tagged the offer as just outside the searched area
• listingUrl, sourceUrl, bookingDeepLink
• checkInDate, nights, guests — echoed back when supplied
• recordType: "rental", scrapedAt

Output per destination (mode=autocomplete)

• locationId, name, fullTitle, trail, meta[]
• parentLocationId, destinationType, suggestionCategory
• recordType: "destination", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / searchByLocationId / autocomplete
locationQuery	string	Miami	Free-text destination (mode=search, mode=autocomplete)
locationId	string	–	Known HomeToGo location ID (mode=searchByLocationId)
checkInDate	string	–	YYYY-MM-DD trip start date
nights	int	7	Length of stay (applied only if checkInDate set)
guests	int	–	Total guest count
propertyType	string	–	One of 17 accommodation types (condo, cabin, apartment, house, hotel, etc.)
amenities	array	[]	Require ALL selected amenities (WiFi, pool, pet-friendly, etc.)
minPricePerNight / maxPricePerNight	int	–	Price bounds, unit set by priceType
priceType	string	totalPrice	totalPrice / perNight
minSizeSqm / maxSizeSqm	int	–	Property size bounds (m²)
sortBy	string	default	default (most popular) / best_value
includeNearby	bool	true	Include offers HomeToGo tags as just outside the destination
maxItems	int	50	Hard cap (1–2000)

Example: search a destination with dates and filters

{
  "mode": "search",
  "locationQuery": "Miami",
  "checkInDate": "2026-09-10",
  "nights": 7,
  "guests": 4,
  "propertyType": "condo",
  "amenities": ["pool", "internet"],
  "maxItems": 100
}

Example: search by a known location ID

{
  "mode": "searchByLocationId",
  "locationId": "5460aeb030147",
  "maxPricePerNight": 300,
  "priceType": "perNight"
}

Example: destination lookup

{
  "mode": "autocomplete",
  "locationQuery": "Aspen"
}

Use cases

• Travel search / metasearch aggregators — build a comparison feed of vacation rental prices across destinations
• Market research — track nightly rate ranges and property-type mix in a destination over time
• Real estate / short-term-rental analytics — benchmark amenities and pricing for comparable listings
• Travel content — power "best value stays in X" articles with real, current listings
• Lead generation — surface direct booking links for travel affiliate programs

FAQ

What is HomeToGo? A vacation rental metasearch engine that aggregates millions of offers from providers like Vrbo, Booking.com, and TUI Villas into one searchable index, similar to how Kayak aggregates flights.

How do I find a locationId for mode=searchByLocationId? Run mode=autocomplete with your destination text first, or run mode=search once — the actor logs the resolved locationId for reuse in future runs.

Why do some offers have no sizeSqm? Not every listing publishes a floor area; the field is only included when HomeToGo returns it.

What currency are prices in? priceCurrency reflects whatever market HomeToGo serves for the request's origin (commonly USD for US-run actors). The priceDisplay field always shows the exact string HomeToGo returned, so you can always see the real currency symbol even if priceCurrency differs from what you expected.

Why did I get fewer results than maxItems? HomeToGo returns real listings for the applied filters only; if a destination + filter combination has few matching offers, the actor stops early rather than padding output with placeholder data.

Does this scraper book reservations? No — it's read-only. listingUrl and bookingDeepLink point to the live HomeToGo listing/checkout flow for humans to complete a booking themselves.

Is nearby/expanded-radius data reliable? Offers with nearby: true are ones HomeToGo itself flags as being outside the exact searched area but shown as an alternative. Set includeNearby: false to exclude them.