# VRBO Listing Scraper (`integrative_tangent/vrbo-listing-scraper`) Actor Scrape VRBO vacation rental listings with pricing, ratings, amenities, photos & host details. Search by location name, bounding box, search URL, or property ID. Returns 35+ fields per listing including cleaning fees, house rules & cancellation policy. - **URL**: https://apify.com/integrative\_tangent/vrbo-listing-scraper.md - **Developed by:** [Luis Segura](https://apify.com/integrative_tangent) (community) - **Categories:** E-commerce, Travel, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 vrbo listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Listing Scraper Extract full vacation rental data from VRBO (Vrbo.com) — the world's second-largest short-term rental platform with over 2 million listings. Get nightly pricing, ratings, amenities, host details, cancellation policies, house rules, and photos for any property or geographic area. **No VRBO account required. No API key needed.** --- ### What You Get For every listing scraped, you receive a structured JSON record with **35+ data fields**: | Category | Fields | |---|---| | **Basic Info** | Title, description, property type | | **Capacity** | Bedrooms, beds, bathrooms, max guests | | **Location** | Latitude, longitude, city, state, country, postal code | | **Pricing** | Price/night, cleaning fee, weekly discount %, monthly discount %, currency | | **Ratings** | Overall rating (out of 5), total review count | | **Policies** | Check-in/out time, cancellation policy, min/max nights | | **House Rules** | Pets allowed, smoking allowed, events allowed, children allowed | | **Booking** | Instant booking (yes/no) | | **Host** | Host name, ID, member since, response rate, languages spoken | | **Amenities** | Full flat list + grouped by category (Kitchen, Outdoor, Entertainment, etc.) | | **Photos** | Up to 30 photo URLs | --- ### 5 Ways to Use It #### Mode A — Scrape specific properties by ID You already know which VRBO listings you want. Provide the numeric IDs from the URLs. ```json { "propertyIds": ["1234567", "8901234", "5551212"] } ```` #### Mode B — Scrape from URLs Paste one or more VRBO listing URLs directly. ```json { "urls": [ "https://www.vrbo.com/1234567", "https://www.vrbo.com/8901234ha" ] } ``` #### Mode C — Scrape from a search URL Search on VRBO, zoom the map to your area, copy the browser URL, paste it here. ```json { "searchUrl": "https://www.vrbo.com/vacation-rentals/usa/florida?neLat=26.0&neLng=-80.0&swLat=25.5&swLng=-80.5" } ``` #### Mode D — Scrape by bounding box Define a geographic rectangle with GPS coordinates. ```json { "boundingBox": { "ne_lat": 25.85, "ne_lng": -80.11, "sw_lat": 25.75, "sw_lng": -80.15 } } ``` #### Mode E — Scrape by location name (easiest) Type any city, neighborhood, or region. The actor geocodes it automatically. ```json { "location": "Miami Beach, Florida", "maxListings": 100 } ``` Other examples: - `"Punta Cana, Dominican Republic"` - `"Tulum, Mexico"` - `"Smoky Mountains, Tennessee"` - `"Lake Tahoe, California"` - `"Outer Banks, North Carolina"` *** ### Sample Output ```json { "propertyId": "1234567", "scrapedAt": "2025-08-15T14:32:00.000Z", "details": { "url": "https://www.vrbo.com/1234567", "title": "Oceanfront Paradise with Private Pool – Walk to Beach", "description": "Escape to this stunning oceanfront villa with sweeping Atlantic views...", "propertyType": "Villa", "bedrooms": 4, "beds": 5, "bathrooms": 3, "maxGuests": 10, "latitude": 25.7825, "longitude": -80.1340, "city": "Miami Beach", "stateProvince": "FL", "country": "US", "postalCode": "33139", "overallRating": 4.9, "reviewCount": 127, "pricePerNight": 489, "currency": "USD", "cleaningFee": 250, "weeklyDiscount": 10, "monthlyDiscount": 20, "checkInTime": "4:00 PM", "checkOutTime": "10:00 AM", "cancellationPolicy": "Strict", "minNights": 3, "maxNights": 30, "petsAllowed": false, "smokingAllowed": false, "eventsAllowed": false, "childrenAllowed": true, "instantBooking": true, "hostId": "987654", "hostName": "Sarah M.", "hostMemberSince": "2018-03-01", "hostResponseRate": "98%", "hostLanguages": ["English", "Spanish"], "amenities": ["WiFi", "Private pool", "Air conditioning", "Kitchen", "Washer"], "amenityCategories": { "Outdoor": ["Private pool", "Hot tub", "BBQ grill", "Ocean view"], "Kitchen": ["Refrigerator", "Stove", "Microwave", "Dishwasher"], "Entertainment": ["Smart TV", "WiFi"], "Essentials": ["Air conditioning", "Washer", "Dryer", "Free parking"] }, "photoCount": 48, "photoUrls": [ "https://images.vrbo.com/listings/12345/1.jpg", "https://images.vrbo.com/listings/12345/2.jpg" ] } } ``` *** ### Use Cases - **Short-term rental market research** — Analyze pricing, supply, and saturation in any area - **Competitive intelligence** — Track competitor listings, amenities, and pricing strategies - **Revenue management** — Build dynamic pricing models based on comparable properties - **Real estate investment analysis** — Evaluate short-term rental potential before buying a property - **Travel tech & aggregators** — Power search and comparison tools - **Academic research** — Study vacation rental market dynamics and pricing patterns - **Property management** — Monitor and benchmark your own portfolio *** ### Pricing & Cost This actor uses **pay-per-result** pricing — you only pay for the listings actually scraped. | Volume | Cost | |---|---| | 100 listings | $0.20 | | 500 listings | $1.00 | | 1,000 listings | $2.00 | | 5,000 listings | $10.00 | | 10,000 listings | $20.00 | > **Tip:** Start with `maxListings: 10` to verify the output format before running a full scrape. *** ### Proxy Recommendations | Volume | Recommendation | |---|---| | 1–50 listings | No proxy needed | | 50–200 listings | Apify Datacenter Proxy | | 200+ listings | **Apify Residential Proxy** (recommended) | VRBO uses Akamai CDN with bot protection. Residential proxies bypass this reliably. ```json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` *** ### Tips for Best Results 1. **Start small** — Set `maxListings: 10` for your first run to verify the output format 2. **Use date ranges** — Provide `checkIn` and `checkOut` dates to get accurate nightly pricing 3. **Location + maxListings** — The most common combo: `"location": "Tulum, Mexico", "maxListings": 500` 4. **Dense areas** — The actor uses quadtree subdivision for dense cities to ensure full coverage 5. **Rate limiting** — The actor automatically backs off when VRBO throttles requests *** ### Limitations - **Pricing is date-dependent** — Nightly rates vary by season. Provide check-in/check-out dates for accuracy - **Exact address** — VRBO hides the street address until booking. GPS coordinates are always available - **Dynamic listings** — VRBO listings change frequently. Re-run for fresh data - **Review text** — Review text is not scraped (ratings and counts only) *** ### Legal & Terms of Service This actor scrapes publicly available data from VRBO's website in the same way a browser would. It does not require authentication, bypass any security measures, or access private data. Users are responsible for complying with VRBO's Terms of Service and applicable data protection laws in their jurisdiction. *** ### Related Actors - **Airbnb Listing Scraper** — Same data model for Airbnb properties - **Airbnb Reviews Scraper** — Extract guest reviews and sentiment - **Airbnb Calendar Scraper** — Track availability and occupancy rates *** *Built with ❤️ by RentIQ — tools for short-term rental professionals.* # Actor input Schema ## `propertyIds` (type: `array`): VRBO property IDs to scrape. Example: \["1234567", "8901234"]. These are the numeric IDs from VRBO URLs. ## `urls` (type: `array`): VRBO listing page URLs. Example: \["https://www.vrbo.com/1234567", "https://www.vrbo.com/8901234ha"] ## `searchUrl` (type: `string`): A VRBO search results page URL. The actor will extract the map bounding box and discover all listings in that area. Example: "https://www.vrbo.com/vacation-rentals/usa/florida?neLat=26.0\&neLng=-80.0\&swLat=25.5\&swLng=-80.5" ## `boundingBox` (type: `object`): Geographic bounding box to search for listings. Provide as JSON: { "ne\_lat": 26.0, "ne\_lng": -80.0, "sw\_lat": 25.5, "sw\_lng": -80.5 } ## `location` (type: `string`): Location name to search. The actor will resolve this to a geographic area via OpenStreetMap. Example: "Miami Beach, Florida" or "Punta Cana, Dominican Republic". ## `maxListings` (type: `integer`): Maximum number of listings to process. Set to 0 for unlimited. ## `checkIn` (type: `string`): Check-in date for pricing context (YYYY-MM-DD). Affects nightly price shown. ## `checkOut` (type: `string`): Check-out date for pricing context (YYYY-MM-DD). ## `adultsCount` (type: `integer`): Number of adults for the search query (default: 2). ## `requestsPerSecond` (type: `number`): Starting request rate. The actor adapts automatically — backs off on rate limits and speeds up when safe. Range: 0.3–2. Default: 1. ## `proxyConfiguration` (type: `object`): Configure proxy settings. Residential proxies recommended for bulk runs. ## Actor input object example ```json { "maxListings": 0, "adultsCount": 2, "requestsPerSecond": 1 } ``` # 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("integrative_tangent/vrbo-listing-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("integrative_tangent/vrbo-listing-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 integrative_tangent/vrbo-listing-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=integrative_tangent/vrbo-listing-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "VRBO Listing Scraper", "description": "Scrape VRBO vacation rental listings with pricing, ratings, amenities, photos & host details. Search by location name, bounding box, search URL, or property ID. Returns 35+ fields per listing including cleaning fees, house rules & cancellation policy.", "version": "1.0", "x-build-id": "CDCBjU5cWuljufu14" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/integrative_tangent~vrbo-listing-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-integrative_tangent-vrbo-listing-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/integrative_tangent~vrbo-listing-scraper/runs": { "post": { "operationId": "runs-sync-integrative_tangent-vrbo-listing-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/integrative_tangent~vrbo-listing-scraper/run-sync": { "post": { "operationId": "run-sync-integrative_tangent-vrbo-listing-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": { "propertyIds": { "title": "Property IDs", "type": "array", "description": "VRBO property IDs to scrape. Example: [\"1234567\", \"8901234\"]. These are the numeric IDs from VRBO URLs.", "items": { "type": "string" } }, "urls": { "title": "Property URLs", "type": "array", "description": "VRBO listing page URLs. Example: [\"https://www.vrbo.com/1234567\", \"https://www.vrbo.com/8901234ha\"]", "items": { "type": "string" } }, "searchUrl": { "title": "Search URL", "type": "string", "description": "A VRBO search results page URL. The actor will extract the map bounding box and discover all listings in that area. Example: \"https://www.vrbo.com/vacation-rentals/usa/florida?neLat=26.0&neLng=-80.0&swLat=25.5&swLng=-80.5\"" }, "boundingBox": { "title": "Bounding Box", "type": "object", "description": "Geographic bounding box to search for listings. Provide as JSON: { \"ne_lat\": 26.0, \"ne_lng\": -80.0, \"sw_lat\": 25.5, \"sw_lng\": -80.5 }" }, "location": { "title": "Location", "type": "string", "description": "Location name to search. The actor will resolve this to a geographic area via OpenStreetMap. Example: \"Miami Beach, Florida\" or \"Punta Cana, Dominican Republic\"." }, "maxListings": { "title": "Max Listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to process. Set to 0 for unlimited.", "default": 0 }, "checkIn": { "title": "Check-in Date (optional)", "type": "string", "description": "Check-in date for pricing context (YYYY-MM-DD). Affects nightly price shown." }, "checkOut": { "title": "Check-out Date (optional)", "type": "string", "description": "Check-out date for pricing context (YYYY-MM-DD)." }, "adultsCount": { "title": "Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adults for the search query (default: 2).", "default": 2 }, "requestsPerSecond": { "title": "Requests Per Second", "minimum": 0.3, "maximum": 2, "type": "number", "description": "Starting request rate. The actor adapts automatically — backs off on rate limits and speeds up when safe. Range: 0.3–2. Default: 1.", "default": 1 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxy settings. Residential proxies recommended for bulk runs." } } }, "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 } } } } } } } } } } ```