RedWeek Timeshare Scraper

Scrape RedWeek.com — the world's largest timeshare resale and rental marketplace. Browse resorts by country, US state, or management brand, look up a specific resort's full profile, pull its live rental and resale postings with prices and dates, or grab curated top-25 and featured collections. No login, no cookies, no paid proxy required.

What this actor does

• Six modes: search (browse/keyword resorts), resortDetails (full resort profile), rentals (live rental postings for a resort), resales (live resale postings for a resort), topResorts (curated top-25 rental resorts), featured (curated posting collections)
• Browse axes: by country (117 countries/territories, RedWeek's own region taxonomy), by US state, by timeshare brand/management company (67 brands), or free-text keyword
• Filters (rentals/resales): minimum bedrooms, minimum sleeps, unit view, ownership type (deeded / right-to-use), week type (floating / fixed), sort order
• Rich resort data: description, address, GPS coordinates, star rating and review count, price range, full amenity list
• Rich posting data: check-in/check-out dates, nights, bedrooms/bathrooms/sleeps, unit view, price (per-night and total for rentals; flat price for resales), verification badge, posting date
• Empty fields are omitted — every record only contains fields that had real data

Output per resort (mode = search, topResorts, brand browse)

• resortId, resortUrl, name, location, locality, region
• rating, reviewCount
• latitude, longitude, photoUrl
• rentalCount, rentalPriceMinUsd, rentalPriceMaxUsd
• resaleCount, resalePriceMinUsd, resalePriceMaxUsd
• brand (brand-browse only)
• recordType: "resort" / "topResort", scrapedAt

Output per resort profile (mode = resortDetails)

• resortId, name, resortUrl, description
• streetAddress, locality, region, country, postalCode, latitude, longitude
• ratingValue, ratingCount, reviewCount
• priceMinUsd, priceMaxUsd, priceRangeDisplay
• amenities[], amenityCount
• photoUrl, mapUrl, sourceUrl
• recordType: "resortDetail", scrapedAt

Output per rental posting (mode = rentals)

• postingId, postingUrl, resortId, resortName, resortUrl
• checkIn, checkOut, nights
• bedrooms, bathrooms, sleeps, view, unitDescription
• pricePerNightUsd, priceTotalUsd
• verified, isNew, postingDate
• recordType: "rentalPosting", scrapedAt

Output per resale posting (mode = resales)

• postingId, postingUrl, resortId, resortName, resortUrl
• priceUsd, bedrooms, bathrooms, sleeps, view
• weekType, weekNumber, useType, ownershipType, unitDescription
• verified, isNew, postingDate
• recordType: "resalePosting", scrapedAt

Output per featured posting (mode = featured)

• postingId, postingUrl, resortName, rating, location
• datesText, unitDescription, bedrooms, bathrooms, sleeps
• priceTotalUsd, pricePerNightUsd, photoUrl, verified, collection
• recordType: "featuredPosting", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / resortDetails / rentals / resales / topResorts / featured
searchQuery	string	–	Free-text keyword search (mode=search); takes priority over country/brand
country	string	Aruba	Browse resorts in a country (mode=search)
usState	string	–	Narrow a United States browse to one state (mode=search)
brand	string	–	Browse all resorts of a timeshare brand/management company (mode=search)
resortIds	array	["P4872"]	Resort IDs or URLs (mode=resortDetails/rentals/resales)
collection	string	newest-timeshare-rentals	Curated collection to fetch (mode=featured)
bedroomsMin	int	–	Minimum bedrooms (mode=rentals/resales)
sleepsMin	int	–	Minimum sleeps (mode=rentals/resales)
view	string	any	Unit view filter (mode=rentals/resales)
ownershipType	string	any	Deeded / right-to-use filter (mode=resales)
weekType	string	any	Floating / fixed week filter (mode=resales)
sortBy	string	relevance	Sort order for postings (mode=rentals/resales)
maxItems	int	50	Hard cap on emitted records (1–2000)

Example: browse resorts in Aruba (default)

{ "mode": "search", "country": "Aruba", "maxItems": 20 }

Example: keyword search

{ "mode": "search", "searchQuery": "Marriott Aruba" }

Example: browse resorts by US state

{ "mode": "search", "country": "United States", "usState": "Hawaii", "maxItems": 20 }

Example: browse resorts by brand

{ "mode": "search", "brand": "marriott", "maxItems": 20 }

Example: full profile for a resort

{ "mode": "resortDetails", "resortIds": ["P4872"] }

Example: live rentals for a resort, 2+ bedrooms, ocean view, cheapest first

{
  "mode": "rentals",
  "resortIds": ["P4872"],
  "bedroomsMin": 2,
  "view": "Ocean view",
  "sortBy": "priceLowToHigh",
  "maxItems": 50
}

Example: deeded fixed-week resales for a resort

{
  "mode": "resales",
  "resortIds": ["P4872"],
  "ownershipType": "Deed",
  "weekType": "Fixed",
  "maxItems": 50
}

Example: curated top-25 rental resorts

{ "mode": "topResorts", "maxItems": 25 }

Example: featured Disney vacation rentals

{ "mode": "featured", "collection": "disney-timeshare-rentals", "maxItems": 20 }

Use cases

• Timeshare buyers/renters — compare live rental and resale prices across resorts before booking or buying
• Resort/brand research — pull every resort in a management company's portfolio (Marriott, Disney, Hilton Grand Vacations, Wyndham, and 60+ more)
• Regional market analysis — browse by country/state to see resort density, ratings, and price ranges by destination
• Deal discovery — filter live postings by bedrooms, view, ownership type, or week type to find postings matching specific needs
• Content curation — pull RedWeek's own curated collections (top-25, featured, seasonal) for travel content or newsletters

Data source & limitations

This actor reads RedWeek's own publicly browsable pages — the same resort profiles, rental listings, and resale listings an anonymous visitor sees without creating an account or logging in. No login, cookies, or paid proxy are used or required to run this actor.

Contacting a specific owner/lister requires a RedWeek account. This actor reads posting details (price, dates, unit specs) exactly as shown on the public listing page. Messaging an owner, saving a listing, or completing a booking/purchase all require a RedWeek account and happen entirely on RedWeek's own site — they are outside the scope of this actor.

rentals/resales filters are applied to postings after they're fetched from the resort's listing page, since RedWeek's listing pages don't expose bedroom/view/ownership filters as server-side query parameters for every combination. The actor always fetches the full current posting list for the requested resort(s) before filtering, so results reflect the true live inventory.

Region taxonomy (country → continent grouping) mirrors RedWeek's own site navigation (/search/{continent}/{country}-timeshares) as verified against the live site.

FAQ

Is this affiliated with RedWeek? No. This is an independent, third-party actor that reads RedWeek's own publicly browsable resort and posting pages. It is not affiliated with, endorsed by, or supported by RedWeek LLC.

Do I need an account or to log in? No. Browsing resorts, rentals, and resales on RedWeek does not require an account — the actor only reads public listing pages; it never logs in or bids on your behalf.

What's the difference between "rentals" and "resales"? Rentals are short-term week bookings (check-in/check-out dates, nightly rate) — like renting someone's timeshare week for a vacation. Resales are permanent ownership transfers (a flat price for the deeded or right-to-use week itself).

What's a "floating" vs. "fixed" week? A fixed week is locked to a specific numbered week of the year (e.g. week 32). A floating week can be used at various times within a season, subject to availability.

What's the difference between "Deed" and "RTU" ownership? A deeded week is real property you own outright and can pass on or sell. A right-to-use (RTU) week is a long-term lease/license for a set number of years, after which ownership reverts to the resort/developer.

Why do some postings have very few output fields? Every field is only included when the lister actually provided it. A blank unit description or missing view field means the lister didn't specify one — the actor never fabricates placeholder values.

Can I search by resort name instead of browsing by country? Yes — set mode: "search" and provide searchQuery with the resort or destination name; it takes priority over country/brand.

How fresh is the data? Real-time — every run reads live data directly from the current pages; prices, dates, and availability reflect the moment the actor ran.

Does this actor complete bookings or purchases for me? No. This actor only reads and returns publicly available listing data. Booking a rental or purchasing a resale requires a RedWeek account and using RedWeek's own website directly.