# VRBO Scraper - Vacation Rentals, Prices & Reviews (`khadinakbar/vrbo-scraper`) Actor Scrape VRBO vacation rentals by destination or URL — listings, full property detail, and guest reviews. Akamai-hardened, MCP-ready. - **URL**: https://apify.com/khadinakbar/vrbo-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Travel, Real estate, MCP servers - **Stats:** 1 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 listing or property scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## VRBO Scraper - Vacation Rentals, Prices & Reviews **Scrape [VRBO](https://www.vrbo.com) vacation rentals at scale** — search any destination, pull full **property details**, and collect **guest reviews**, all from one Actor. Give it a place name or paste VRBO URLs and get clean, structured JSON with prices, ratings, bedrooms, location, amenities, and reviews. Built for **short-term-rental investors, property managers, and market analysts**, and ready to call as an **MCP tool** from Claude or any AI agent. It runs on the Apify platform, so you get API access, scheduling, integrations (Make, Zapier, Google Drive), residential proxy rotation, and run monitoring out of the box. ### What does VRBO Scraper do? VRBO Scraper extracts vacation-rental data from VRBO (Vacation Rentals by Owner, part of Expedia Group). It auto-detects what you give it: - **A destination** (e.g. `Destin, Florida`) → searches VRBO and returns listing cards, auto-paginating up to your limit. - **A search URL** (`https://www.vrbo.com/search?destination=...`) → same, but from your exact filtered search. - **A property URL or ID** (`https://www.vrbo.com/1234567` or just `1234567`) → returns the full property record plus guest reviews. VRBO is protected by Akamai Bot Manager, so this Actor uses a stealth **Camoufox** (Firefox) browser over **residential proxies** with a session warmup, then extracts data from the page's own structured JSON for accuracy. ### Why use VRBO Scraper? - **Pricing & availability intelligence** — benchmark nightly rates across a market or a comp set. - **Investment & arbitrage research** — size up bedrooms, sleeps, ratings, and review volume per area. - **Lead lists for property managers** — find owner-listed rentals in a target city. - **Review mining** — pull guest reviews for sentiment and quality analysis. - **One Actor, three jobs** — search, detail, and reviews instead of stitching three tools together. ### How to use VRBO Scraper 1. Click **Try for free**. 2. Enter a **Destination** (or paste VRBO **Start URLs** — search or property). 3. (Optional) Set **check-in/check-out** dates for stay-specific prices, and **Max results**. 4. (Optional) Turn on **Visit each listing for full detail** to get amenities, host, exact geo, and reviews for every search result. 5. Click **Start**. Download results as JSON, CSV, Excel, or HTML, or pull them via the [Apify API](https://docs.apify.com/api/v2). ### Input | Field | Type | Description | |---|---|---| | `destination` | string | Free-text place to search (e.g. `Lake Tahoe`). | | `startUrls` | array | VRBO search or property URLs/IDs. Mode auto-detected. | | `checkIn` / `checkOut` | string | `YYYY-MM-DD` stay window for priced search. | | `adults` | integer | Guests for pricing (default 2). | | `maxResults` | integer | Cap on listing/property records (default 50). | | `enrichDetails` | boolean | Visit each search result for full detail + reviews (default off). | | `includeReviews` | boolean | Return guest reviews on property pages (default on). | | `maxReviewsPerProperty` | integer | Review cap per property (default 20). | #### Example input ```json { "destination": "Destin, Florida, United States of America", "maxResults": 50, "enrichDetails": false, "includeReviews": true } ```` ### Output Each result is one flat JSON record. `recordType` is `listing`, `property`, or `review`. Reviews link back to their property via `propertyId`. ```json { "recordType": "property", "id": "1234567", "url": "https://www.vrbo.com/1234567", "name": "Beachfront Condo with Gulf Views", "propertyType": "Condo", "bedrooms": 2, "bathrooms": 2, "sleeps": 6, "rating": 4.8, "reviewCount": 137, "priceLabel": "$245 / night", "pricePerNight": 245, "currency": "USD", "city": "Destin", "region": "Florida", "country": "United States", "latitude": 30.3935, "longitude": -86.4958, "amenities": ["Pool", "Wi-Fi", "Beach access", "Air conditioning"], "host": "Gulf Coast Rentals", "imageUrl": "https://...jpg", "scrapedAt": "2026-06-14T10:00:00.000Z" } ``` ```json { "recordType": "review", "propertyId": "1234567", "rating": 5, "title": "Perfect beach getaway", "text": "Spotless unit, steps from the sand. Host was responsive...", "reviewer": "Jennifer M.", "stayDate": "2026-04", "scrapedAt": "2026-06-14T10:00:00.000Z" } ``` You can download the dataset in JSON, CSV, Excel, or HTML. #### Data fields | Field | Description | |---|---| | `recordType` | `listing`, `property`, or `review` | | `id` | VRBO listing/property id | | `name` | Listing / property headline | | `propertyType` | Condo, House, Cabin, etc. | | `bedrooms`, `bathrooms`, `sleeps` | Capacity | | `rating`, `reviewCount` | Average guest rating + count | | `priceLabel`, `pricePerNight`, `currency` | Pricing | | `city`, `region`, `country`, `latitude`, `longitude` | Location | | `amenities`, `host`, `description` | Property detail (detail/property records) | | `title`, `text`, `reviewer`, `stayDate`, `propertyId` | Review records | | `url`, `sourceUrl`, `scrapedAt` | Provenance | ### Pricing — how much does it cost to scrape VRBO? This Actor uses **pay-per-event** pricing: | Event | Price | |---|---| | Actor start | $0.00005 | | Listing or property scraped | **$0.003** | | Review scraped | $0.001 | So 100 listings ≈ **$0.30**. 100 listings with 20 reviews each ≈ $0.30 + $2.00. You only pay for records you receive. Apify's free tier covers small runs. Pay-per-usage (compute + proxy) is also available for very large jobs. ### Tips & advanced options - Keep **Max results** tight to control cost — pagination stops at the cap. - Leave **Visit each listing** off for fast, cheap market sweeps; turn it on when you need amenities, host, exact geo, and reviews. - Use **check-in/check-out** for accurate nightly prices; without them you get indicative "from" prices. - Residential US proxy is the default and recommended — VRBO blocks datacenter IPs. - Intermittent blocks can happen on heavily protected pages; re-run, or configure a paid Web Unlocker fallback (advanced, owner-configured). ### FAQ, disclaimers & support **Is scraping VRBO legal?** This Actor collects only publicly available information. You are responsible for how you use the data and for complying with VRBO's Terms of Service and applicable laws (including data-protection rules). Do not use scraped personal data unlawfully. **Why did I get fewer results than expected?** Heavy anti-bot protection can intermittently block requests; retry, narrow the destination, or enable a paid unlocker. The Actor fails honestly (not silently) when every request is blocked. **Does it scrape Expedia or Hotels.com?** No — this Actor targets VRBO vacation rentals. See the rest of the [khadinakbar portfolio](https://apify.com/khadinakbar) for related travel scrapers (Airbnb, TripAdvisor). **Support:** open an issue on the Actor's Issues tab. Custom field or volume requirements? Get in touch. # Actor input Schema ## `destination` (type: `string`): Use this to search VRBO by place: a free-text city, region, or area such as 'Destin, Florida, United States of America' or 'Lake Tahoe'. The actor opens VRBO search, collects vacation-rental listings, and auto-paginates up to Max results. Leave empty if you instead pass property or search URLs in Start URLs. NOT a property URL — to scrape one rental use Start URLs. ## `startUrls` (type: `array`): Use this for exact VRBO URLs instead of a text search. Accepts VRBO search-result URLs (https://www.vrbo.com/search?destination=...) and individual property URLs or IDs (https://www.vrbo.com/1234567 or just 1234567). Each URL's mode (search vs property) is auto-detected. Mixed lists are fine; non-VRBO URLs are skipped with a warning. ## `checkIn` (type: `string`): Optional stay start date in YYYY-MM-DD format (e.g. '2026-08-01') used to fetch availability-aware nightly prices in search mode. Leave empty for undated 'from' prices. Must be earlier than Check-out. NOT a duration — pass an explicit calendar date. ## `checkOut` (type: `string`): Optional stay end date in YYYY-MM-DD format (e.g. '2026-08-08'), paired with Check-in to price a specific stay window. Leave empty for undated prices. Must be after Check-in or both dates are ignored. NOT the number of nights — pass a calendar date. ## `adults` (type: `integer`): Number of adult guests used to filter and price search results (e.g. 4). Defaults to 2. Range 1–16. Ignored for direct property URLs. ## `maxResults` (type: `integer`): Hard cap on how many listing/property records to return across all inputs (e.g. 100). Defaults to 50. Pagination stops once this is reached, so it also bounds cost. Reviews do not count against this cap. ## `enrichDetails` (type: `boolean`): When on, every search result is opened on its own property page to collect full fields (description, amenities, host, exact geo) and reviews. When off (default), search returns faster, cheaper listing cards only. Direct property URLs always return full detail regardless of this flag. Turning this on increases run time and cost. ## `includeReviews` (type: `boolean`): When on (default), property pages also return guest reviews as separate review records linked by propertyId. Applies to direct property URLs and, when Visit each listing is on, to search results too. Turn off to skip reviews entirely. Each review is billed separately — see pricing. ## `maxReviewsPerProperty` (type: `integer`): Upper bound on reviews fetched per property (e.g. 20). Defaults to 20, max 200. Set 0 to disable reviews even if Include reviews is on. Caps per-property review cost. ## `debugDumpToKv` (type: `boolean`): Diagnostic only. When on, saves raw HTML, script summaries, and intercepted API payloads to the key-value store (DEBUG-\* keys) to troubleshoot extraction. Leave off for normal runs. Does not change billing. ## `proxyConfiguration` (type: `object`): Proxy settings. VRBO is protected by Akamai, so residential proxies are strongly recommended and on by default (US). Datacenter proxies will be blocked. Leave default unless you have a reason to change country or group. ## Actor input object example ```json { "destination": "Lake Tahoe", "startUrls": [ { "url": "https://www.vrbo.com/1234567" } ], "checkIn": "2026-08-01", "checkOut": "2026-08-08", "adults": 2, "maxResults": 50, "enrichDetails": false, "includeReviews": true, "maxReviewsPerProperty": 20, "debugDumpToKv": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "destination": "Destin, Florida, United States of America", "startUrls": [], "maxResults": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/vrbo-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "destination": "Destin, Florida, United States of America", "startUrls": [], "maxResults": 50, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/vrbo-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "destination": "Destin, Florida, United States of America", "startUrls": [], "maxResults": 50 }' | apify call khadinakbar/vrbo-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/vrbo-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "VRBO Scraper - Vacation Rentals, Prices & Reviews", "description": "Scrape VRBO vacation rentals by destination or URL — listings, full property detail, and guest reviews. Akamai-hardened, MCP-ready.", "version": "1.1", "x-build-id": "YSJJnGmITXpVUcAKV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~vrbo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-vrbo-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/khadinakbar~vrbo-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-vrbo-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/khadinakbar~vrbo-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-vrbo-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "destination": { "title": "Destination (search)", "type": "string", "description": "Use this to search VRBO by place: a free-text city, region, or area such as 'Destin, Florida, United States of America' or 'Lake Tahoe'. The actor opens VRBO search, collects vacation-rental listings, and auto-paginates up to Max results. Leave empty if you instead pass property or search URLs in Start URLs. NOT a property URL — to scrape one rental use Start URLs." }, "startUrls": { "title": "Start URLs (search or property)", "type": "array", "description": "Use this for exact VRBO URLs instead of a text search. Accepts VRBO search-result URLs (https://www.vrbo.com/search?destination=...) and individual property URLs or IDs (https://www.vrbo.com/1234567 or just 1234567). Each URL's mode (search vs property) is auto-detected. Mixed lists are fine; non-VRBO URLs are skipped with a warning.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Optional stay start date in YYYY-MM-DD format (e.g. '2026-08-01') used to fetch availability-aware nightly prices in search mode. Leave empty for undated 'from' prices. Must be earlier than Check-out. NOT a duration — pass an explicit calendar date." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Optional stay end date in YYYY-MM-DD format (e.g. '2026-08-08'), paired with Check-in to price a specific stay window. Leave empty for undated prices. Must be after Check-in or both dates are ignored. NOT the number of nights — pass a calendar date." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adult guests used to filter and price search results (e.g. 4). Defaults to 2. Range 1–16. Ignored for direct property URLs.", "default": 2 }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on how many listing/property records to return across all inputs (e.g. 100). Defaults to 50. Pagination stops once this is reached, so it also bounds cost. Reviews do not count against this cap.", "default": 50 }, "enrichDetails": { "title": "Visit each listing for full detail", "type": "boolean", "description": "When on, every search result is opened on its own property page to collect full fields (description, amenities, host, exact geo) and reviews. When off (default), search returns faster, cheaper listing cards only. Direct property URLs always return full detail regardless of this flag. Turning this on increases run time and cost.", "default": false }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "When on (default), property pages also return guest reviews as separate review records linked by propertyId. Applies to direct property URLs and, when Visit each listing is on, to search results too. Turn off to skip reviews entirely. Each review is billed separately — see pricing.", "default": true }, "maxReviewsPerProperty": { "title": "Max reviews per property", "minimum": 0, "maximum": 200, "type": "integer", "description": "Upper bound on reviews fetched per property (e.g. 20). Defaults to 20, max 200. Set 0 to disable reviews even if Include reviews is on. Caps per-property review cost.", "default": 20 }, "debugDumpToKv": { "title": "Debug: dump raw page to key-value store", "type": "boolean", "description": "Diagnostic only. When on, saves raw HTML, script summaries, and intercepted API payloads to the key-value store (DEBUG-* keys) to troubleshoot extraction. Leave off for normal runs. Does not change billing.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. VRBO is protected by Akamai, so residential proxies are strongly recommended and on by default (US). Datacenter proxies will be blocked. Leave default unless you have a reason to change country or group.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```