Real-Time Short-Term Rental & Hospitality Yield API

Scrape real-time pricing, occupancy rates, and amenities for Airbnb, VRBO, and Booking.com properties in any geo-radius. Built for property managers, real estate investors, and dynamic pricing engines.

🎯 What It Does

This Actor searches short-term rental platforms by geographic coordinates and returns structured listing data with:

• Real-time pricing — nightly rates, cleaning fees, service fees, weekly/monthly discounts
• Occupancy analysis — 30/60/90-day availability windows
• Yield calculation — estimated monthly revenue, average occupancy, top neighborhoods
• Review sentiment — positive/negative keywords, common complaints, sentiment score
• Host data — superhost status, response rate, response time
• Price drop detection — identify listings dropping prices by >20%

📥 Input

Field	Type	Required	Default	Description
lat	number	✅	—	Center latitude
lng	number	✅	—	Center longitude
radius_km	integer	❌	10	Search radius in km (max 50)
platform	string	❌	"airbnb"	airbnb, vrbo, booking.com, or all
checkin	string	❌	today+7	Check-in date (YYYY-MM-DD)
nights	integer	❌	1	Length of stay
guests	integer	❌	2	Number of adults
max_results	integer	❌	50	Max listings per platform (max 500)
include_reviews	boolean	❌	false	Analyze review sentiment
include_host_data	boolean	❌	false	Fetch host data
price_drop_threshold	integer	❌	20	Price drop detection threshold (%)

Example Input

{
  "lat": 29.7628,
  "lng": -95.3630,
  "radius_km": 10,
  "platform": "airbnb",
  "max_results": 50,
  "nights": 1,
  "guests": 2,
  "include_reviews": true
}

📤 Output

Each listing is pushed to the dataset as a structured RentalListing object. A yield analysis summary is stored in the Key-Value Store under the key YIELD_ANALYSIS.

Sample Listing

{
  "platform": "airbnb",
  "listing_id": "32073378",
  "title": "Beautiful Downtown Loft",
  "property_type": "Apartment",
  "nightly_price": 120,
  "currency": "USD",
  "cleaning_fee": 45,
  "rating": 4.85,
  "review_count": 234,
  "superhost": true,
  "instant_bookable": true,
  "location": {
    "lat": 29.76,
    "lng": -95.36,
    "city": "Houston",
    "neighborhood": "Downtown"
  },
  "availability": {
    "available_days_30": 12,
    "available_days_60": 25,
    "available_days_90": 40
  }
}

Yield Analysis (Key-Value Store)

{
  "total_listings": 50,
  "average_nightly_price": 145.50,
  "median_nightly_price": 120,
  "average_occupancy_rate_30d": 58.0,
  "estimated_monthly_revenue": 2528,
  "superhost_percentage": 35.0,
  "top_neighborhoods": [
    { "name": "Downtown", "listing_count": 15, "average_price": 165, "estimated_revenue": 2870 },
    { "name": "Midtown", "listing_count": 12, "average_price": 140, "estimated_revenue": 2436 }
  ]
}

💡 Use Cases

1. Real Estate Investment — Calculate ROI before purchasing a property
2. Dynamic Pricing — Set optimal nightly rates based on competitor data
3. Market Research — Analyze neighborhood-level rental performance
4. Competitor Analysis — Track pricing changes of competing properties
5. Revenue Optimization — Identify underpriced or overpriced listings

🔧 Technical Details

• Runtime: Node.js 20 + Playwright + TypeScript
• Browser: Stealth Chromium with anti-bot evasion scripts
• Scraping method: Network interception (GraphQL) + DOM fallback parsing
• Platforms: Airbnb (primary), VRBO, Booking.com
• Concurrency: Sequential per platform (avoids rate limiting)

📊 Pay-Per-Event Pricing

Event	Price	Charged when
listing-scraped	$0.02	For every listing returned
listing-enriched	$0.01	When reviews or host data are extracted

License

MIT