# Changelog of Vrbo Scraper + STR Market KPIs (ADR · Occupancy · RevPAR) (`sian.agency/vrbo-property-scraper`) Actor

- **URL**: https://apify.com/sian.agency/vrbo-property-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/sian.agency/vrbo-property-scraper.md

## Changelog

All notable changes to **Vrbo Property Scraper** will be documented in this file.

### \[2026-09-11]

#### 🖼️ Images

- 🖼️ **The photos were always collected — now you can see them.** The full image gallery and its preview thumbnail appear in the Output tab and in every export, instead of only in the raw JSON.

### \[2026-08-24]

#### 📄 New run report — the market read, the money and the retry on one page

- **Value-first market report** — every run now opens with the numbers you came for: listings collected, median ADR, occupancy and estimated annual revenue, plus a one-click copy of the whole Vrbo market brief straight into your underwriting note.
- **Top listings ranked by earnings** — the highest-earning comps first, with nightly rate, ADR, occupancy rate and estimated annual revenue side by side.
- **Itemised charges** — a plain statement of every event this run billed, with the total. Nothing that failed appears on it.
- **Enrichment coverage, explained** — when a calendar, review feed or host profile comes back empty, the report says how many and why instead of showing a bare count.
- **One-click retry for gaps** — a search that failed or came back empty now ships a ready-to-paste input that re-runs just those searches, with the same enrichment settings.
- **Run it from your own stack** — the report carries the exact command for the run you just did, plus an MCP config so an AI agent can run this Vrbo scraper in plain language.

#### 💎 User Benefits

- Read the market without opening the dataset — ADR, occupancy and RevPAR are on the first screen
- Know exactly what you paid for, per event, on every run
- Recover a partial market scan in one paste instead of rebuilding the search by hand

### \[2026-08-05]

#### 💰 You are only charged when an enrichment returns data

- **No charge for an empty calendar** — a listing whose forward calendar comes back with no nights no longer bills an availability charge. Occupancy and RevPAR are only paid for when they can actually be computed.
- **No charge for an empty review feed** — a listing with no reviews yet is no longer billed as a review enrichment.
- **No charge for a missing host profile** — a listing with no host record attached is no longer billed as a host enrichment.

#### 💎 User Benefits

- Scanning thin or brand-new markets costs less: rows still arrive, empty enrichments cost nothing
- Your invoice matches the data you can actually model with

### \[2026-07-30]

#### 🔗 Fixed — Bulk URL input now works

- Pasting a list of Vrbo URLs failed with "Invalid Vrbo URL" before fetching anything. Bulk lists (`vrboUrls`, PAID) now work from the UI or the API, and duplicates are collapsed.

### \[2026-05-19]

#### 🎉 Vrbo Property Scraper — Launch!

- **STR Investor KPIs Built-In** — Every listing ships with `adr`, `occupancyRate`, `revpar`, `estimatedAnnualRevenue`, and `isStale` computed from per-listing calendar enrichment. No spreadsheet wrangling, no extra integrations.
- **5 Search Modes** — Search Vrbo by `location`, `coordinates`, `polygon` (lat/lon bounding), `url`, or direct `propertyId`.
- **Granular Pay-Per-Event Enrichment** — Pick only the data layer you need: `ListingExtracted` (cheap base row), `AvailabilityEnriched` (calendar + KPIs), `ReviewsEnriched` (review feed), `HostEnriched` (host profile). Each opt-in, each priced separately.
- **Tiered Idealista-Style Pricing** — FREE $0.030 → BRONZE $0.012 → SILVER $0.006 → flat $0.003 at GOLD/PLATINUM/DIAMOND. Per-listing cost drops 10× between the FREE tier and the GOLD floor.
- **Auto-Generated HTML Market Report** — Every run saves a market dashboard to `report.html`: ADR distribution, occupancy histogram, RevPAR leaderboard, top hosts, search summary. No extra cost, no extra setup.

#### 🚀 What ships in v1.0.0

- **Search by Location** — City / region / country name, autocomplete-resolved
- **Search by Coordinates** — Lat/lon center + radius
- **Search by Polygon** — Multi-point lat/lon bounding box, irregular shapes supported
- **Search by URL** — Paste a Vrbo search URL, we parse the filters
- **Search by Property ID** — Direct numeric ID lookup
- **AvailabilityEnriched event** — Full forward calendar + nightly prices + STR KPIs
- **ReviewsEnriched event** — Paginated review feed with rating, date, reviewer
- **HostEnriched event** — Host profile, badges (Premier Host), tenure, listing count
- **ListingExtracted event** — Base row with 40+ fields (priced as headline event)

#### 💎 User Benefits

- **Underwrite a deal in minutes** — RevPAR-ranked comp sets, ready for your pro forma
- **Scale without sticker shock** — Tiered curve drops per-listing cost 10× by GOLD tier
- **Pay only for the data layer you need** — Granular events mean no bundled "result" surcharges
- **Hyperlocal market scans** — Polygon search targets ski-town micro-markets, beach strips and neighborhood-level comp sets
- **Ship-ready KPIs** — ADR, occupancy, RevPAR, annual revenue all per-listing, no post-processing

#### 🎯 Use Cases

- STR investors underwriting vacation-rental acquisitions with RevPAR-ranked comp sets
- Vacation-rental property managers sizing TAM for new destinations
- Pricing managers benchmarking competitor RevPAR week-over-week against their portfolio
- Market analysts building 12-month destination revenue forecasts for investor decks
- Operators auditing their own calendar pricing against the live market
- Hospitality consultants delivering polygon-bounded market scans to enterprise clients