# VRBO Property Scraper (`shahidirfan/vrbo-property-scraper`) Actor Scrape VRBO vacation rental listings in bulk. Extract property prices, reviews, availability, and host details. Get accurate market data for competitive analysis and rental research. Reliable, fast property data extraction at scale. - **URL**: https://apify.com/shahidirfan/vrbo-property-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Travel, Automation, Developer tools - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Property Scraper Extract VRBO vacation rental search results into a clean dataset built for analysis, monitoring, and research. Collect listing titles, prices, review signals, cancellation details, gallery images, and direct listing links without the duplicate and empty rows that make raw search data hard to use. ### Features - **Search result collection** — Extract listings from VRBO search URLs or destination-based searches. - **Clean pricing data** — Capture nightly price, total stay price, and price qualifiers in a structured format. - **Review and trust signals** — Collect review score, review label, review count, badges, and cancellation messaging. - **Media-ready output** — Save direct listing URLs, preview images, and image counts for each result. - **Deduplicated dataset** — Filters placeholder cards, repeated properties, and null-heavy records before saving output. ### Use Cases #### Market Research Track pricing, review quality, and property mix across destinations. Compare neighborhoods, demand windows, and listing positioning with cleaner data than manual browsing can provide. #### Travel Planning Data Build searchable shortlists of rentals for internal tools, concierge workflows, or destination research. Use structured prices, cancellation notes, and review signals to rank options faster. #### Competitive Monitoring Monitor how listings appear in destination searches over time. Review changes in nightly rates, visibility, and listing presentation across repeated runs. #### Rental Portfolio Analysis Study what kinds of properties appear for a target market and stay window. Use sleeps, property type, image coverage, and pricing data to benchmark similar rentals. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `property_listings_urls` | Array | No | — | One or more VRBO search or listing URLs to use as starting points. | | `results_wanted` | Integer | No | `30` | Maximum number of unique listings to save. | | `max_pages` | Integer | No | `5` | Maximum number of paginated result pages to request per search. | | `proxyConfiguration` | Object | No | `{"useApifyProxy": true}` | Proxy settings for higher reliability. Residential proxies are recommended. | --- ### Output Data Each dataset item contains: | Field | Type | Description | |-------|------|-------------| | `property_id` | String | Unique property identifier from the search results. | | `title` | String | Listing title shown in VRBO results. | | `listing_url` | String | Direct URL to the listing details page. | | `listing_path` | String | Relative listing path returned by the source. | | `property_type` | String | Property category shown in the card summary. | | `sleeps` | Number | Guest capacity when available in the listing summary. | | `location_text` | String | Area or location label shown in the card. | | `review_score` | Number | Numeric review score. | | `review_label` | String | Review quality label such as `Wonderful` or `Exceptional`. | | `review_count` | Number | Number of reviews shown for the listing. | | `price_per_night` | Number | Nightly price for the selected stay. | | `price_total` | Number | Total displayed price for the stay. | | `price_qualifier` | String | Pricing context such as stay dates or per-night wording. | | `all_fees_included` | Boolean | Whether the card states that all fees are included. | | `cancellation_policy` | String | Cancellation message shown in the card. | | `free_cancellation` | Boolean | Whether the listing advertises free cancellation. | | `image_url` | String | Primary listing image URL. | | `image_count` | Number | Number of gallery images available in the card response. | | `badge_text` | String | Listing badge text when present. | | `currency` | String | Currency used in the result set. | | `search_url` | String | Search URL associated with the extracted record. | | `page_number` | Number | Search page number where the listing was collected. | | `scraped_at` | String | ISO timestamp for when the record was extracted. | --- ### Usage Examples #### Basic Search Extraction ```json { "property_listings_urls": [ "https://www.vrbo.com/search?destination=Las+Vegas%2C+Nevada%2C+United+States+of+America&startDate=2026-06-02&endDate=2026-06-05&adults=2" ], "results_wanted": 30 } ```` #### Larger Result Set ```json { "property_listings_urls": [ "https://www.vrbo.com/search?destination=Miami%2C+Florida%2C+United+States+of+America&startDate=2026-07-10&endDate=2026-07-15&adults=4" ], "results_wanted": 100, "max_pages": 3 } ``` #### Proxy-Hardened Run ```json { "property_listings_urls": [ "https://www.vrbo.com/search?destination=London%2C+England%2C+United+Kingdom&startDate=2026-08-01&endDate=2026-08-05&adults=2" ], "results_wanted": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` *** ### Sample Output ```json { "property_id": "100518043", "title": "In the Heart of Vegas Attractions! Casino, Pool, Game Room, Near Mob Museum!", "listing_url": "https://www.vrbo.com/3721404?chkin=2026-06-02&chkout=2026-06-05&adults=2", "property_type": "Hotel", "sleeps": 2, "location_text": "Within Las Vegas Strip", "review_score": 9.0, "review_label": "Wonderful", "review_count": 20, "price_per_night": 70, "price_total": 209, "price_qualifier": "per night | Jun 2 - Jun 5", "all_fees_included": true, "cancellation_policy": "Free cancellation until May 19", "free_cancellation": true, "image_url": "https://media.vrbo.com/lodging/101000000/100520000/100518100/100518043/09eaa55d.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455", "image_count": 15, "currency": "USD", "page_number": 1, "search_url": "https://www.vrbo.com/search?destination=Las+Vegas%2C+Nevada%2C+United+States+of+America&startDate=2026-06-02&endDate=2026-06-05&adults=2", "scraped_at": "2026-04-24T09:00:00.000Z" } ``` *** ### Tips for Best Results #### Use Real Search URLs - Start with working VRBO search URLs for the destination and stay window you care about. - Keep dates realistic and available enough to return active search results. #### Keep Test Runs Small - Start with `results_wanted` between `20` and `30` while validating new searches. - Increase page count only when you need broader coverage. #### Use Residential Proxies - Residential proxies are the best option for repeatable large runs. - Direct connections may still work locally, but reliability is lower. *** ### Integrations Connect your dataset with: - **Google Sheets** — Review pricing and review trends in a spreadsheet. - **Airtable** — Build searchable property research tables. - **Slack** — Send alerts when fresh listings match your criteria. - **Webhooks** — Deliver cleaned result data to internal systems. - **Make** — Automate downstream enrichment and reporting. - **Zapier** — Trigger actions from newly collected listings. #### Export Formats - **JSON** — Best for APIs and custom applications. - **CSV** — Best for spreadsheet analysis. - **Excel** — Best for reporting and sharing. - **XML** — Useful for legacy integrations. *** ### Frequently Asked Questions #### Does the actor remove duplicates? Yes. Repeated properties and placeholder cards are filtered before data is written to the dataset. #### Why are some fields missing on certain listings? Not every listing shows the same card details in search results. Fields that are not provided are omitted instead of saved as empty values. #### Can I scrape more than one page? Yes. Use `max_pages` and `results_wanted` together to control deeper collection. #### Can I use direct listing URLs? Yes. The actor accepts search and listing URLs, then collects the matching result data available for that stay window. #### What kind of prices are returned? The dataset includes the nightly price when shown, the total stay price when shown, and any pricing qualifier present on the card. *** ### Support For issues or feature requests, contact support through the Apify Console. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Scheduling Runs](https://docs.apify.com/platform/schedules) *** ### Legal Notice This actor is designed for legitimate data collection purposes. Users are responsible for ensuring compliance with applicable terms, policies, and laws when collecting or using data. # Actor input Schema ## `property_listings_urls` (type: `array`): One or more VRBO search/listing URLs. Handles messy URLs and query strings. ## `results_wanted` (type: `integer`): Maximum listing rows to save. ## `max_pages` (type: `integer`): Safety cap for paged API attempts. ## `proxyConfiguration` (type: `object`): Use Apify Proxy for anti-blocking hardening. Residential is recommended. ## Actor input object example ```json { "results_wanted": 30, "max_pages": 5, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/vrbo-property-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 = {} # Run the Actor and wait for it to finish run = client.actor("shahidirfan/vrbo-property-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 '{}' | apify call shahidirfan/vrbo-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/vrbo-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "VRBO Property Scraper", "description": "Scrape VRBO vacation rental listings in bulk. Extract property prices, reviews, availability, and host details. Get accurate market data for competitive analysis and rental research. Reliable, fast property data extraction at scale.", "version": "0.0", "x-build-id": "d5QkrtfQ8En6Mnrto" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~vrbo-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-vrbo-property-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/shahidirfan~vrbo-property-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-vrbo-property-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/shahidirfan~vrbo-property-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-vrbo-property-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": { "property_listings_urls": { "title": "Property Listings URLs", "type": "array", "description": "One or more VRBO search/listing URLs. Handles messy URLs and query strings.", "items": { "type": "string" } }, "results_wanted": { "title": "Results Wanted", "minimum": 1, "type": "integer", "description": "Maximum listing rows to save.", "default": 30 }, "max_pages": { "title": "Max Pages", "minimum": 1, "type": "integer", "description": "Safety cap for paged API attempts.", "default": 5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Use Apify Proxy for anti-blocking hardening. Residential is recommended.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```