🏠 Airbnb Smart Reputation Auditor (AI-Powered)

Turn raw reviews into operational insights using OpenAI (GPT-4o) or DeepSeek.

This Actor is not just a scraper. It is an intelligent auditor for Property Managers and Investors. It scrapes Airbnb reviews and uses a Large Language Model (LLM) to detect "hidden negatives," flag operational issues (cleaning, maintenance, noise), and categorize feedback automatically.

---

🚀 Key Features

• 🧠 AI-Powered Analysis: Uses OpenAI GPT-4o-mini (default) or DeepSeek to understand context, sarcasm, and implied complaints.
• 🕵️ "Hidden Negative" Detection: Flags reviews that have a 5-star rating but contain critical complaints in the text (e.g., "Great stay, but the AC was broken").
• 🏷️ Auto-Categorization: Tags reviews into 5 operational buckets:
  • CLEANLINESS_CRITICAL (Bugs, mold, stains)
  • MAINTENANCE_URGENT (Leaks, broken WiFi, HVAC)
  • ACCESS_SECURITY (Check-in issues, safety)
  • NOISE_ENVIRONMENT (Traffic, neighbors, construction)
  • ACCURACY_ISSUES (Misleading photos)
• ⚡ High Performance: Uses Direct GraphQL API extraction (no slow browser rendering) for maximum speed and cost efficiency.
• 💰 Cost Efficient: Optimized to use GPT-4o-mini for high intelligence at a minimal cost.

---

📥 Input Configuration

💡 Why You Need This (The "Hidden Negative" Problem)

Property Managers and Investors often rely on the average "Star Rating," but this is a dangerous metric. Guests are often polite—they leave 5 stars to be nice, but bury critical operational issues in the text.

The Problem: If you manage 50 units, you cannot read every review. You might see a 5-star rating and assume the property is perfect, missing the fact that the AC is broken or the cleaners are missing spots.

The Solution: This Actor reads between the lines. It detects when a high rating contradicts the actual text.

❌ The Raw Data (What you usually see)

• Guest: Sarah
• Rating: ⭐⭐⭐⭐⭐ (5/5)
• Review: "We loved the location and the host was super nice! The bed was comfy. However, the shower drain was really slow and we found some hair on the bathroom floor."
• Result: You assume everything is fine. The issue gets ignored.

✅ The Smart Analysis (What this Actor gives you)

{
  "analysis": {
    "is_hidden_negative": true,
    "sentiment_score": 0.45,
    "tags": ["MAINTENANCE_URGENT", "CLEANLINESS_CRITICAL"],
    "summary": "Slow drain and hair reported despite 5 stars.",
    "action_required": true
  }
}

• Result: The Actor flags this review as Urgent. Your maintenance team gets an alert about the drain before the next guest arrives, preventing a future 3-star review.

This Actor requires a list of Airbnb Listing URLs and a Proxy configuration.

Example Input (input.json):

{
    "startUrls": [
        { "url": "https://www.airbnb.com/rooms/12345678" },
        { "url": "https://www.airbnb.com/rooms/87654321" }
    ],
    "maxReviews": 20,
    "sortBy": "most_relevant",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

Parameters

Field	Type	Description
startUrls	Array	Required. List of Airbnb Room URLs to audit.
maxReviews	Integer	(Optional) Max reviews to analyze per listing. Default: 10. Set to 0 for all.
sortBy	String	(Optional) Sort order: most_relevant (default), most_recent, highest_rated, lowest_rated.
proxyConfiguration	Object	Required. Airbnb blocks datacenter IPs. You MUST use Residential proxies.

---

📤 Output Example

The Actor stores results in the default Apify Dataset. Each item represents one review.

{
  "startUrl": "https://www.airbnb.com/rooms/12345678",
  "review_id": "12345",
  "created_at": "2023-10-25T14:00:00Z",
  "date_display": "October 2023",
  "language": "en",
  "rating": 5,
  "rating_accessibility_label": "Rating, 5 stars",
  "text": "We loved the location and the host was super nice! However, the shower drain was really slow...",
  "text_original": null,
  "translation_note": null,
  "host_response": null,
  "guest": {
    "id": "98765",
    "name": "Sarah",
    "is_superhost": false,
    "picture_url": "https://a0.muscache.com/im/pictures/user/...",
    "subtitle": "New York, NY"
  },
  "host": {
    "id": "54321",
    "name": "John",
    "is_superhost": true,
    "picture_url": "https://a0.muscache.com/im/pictures/user/..."
  },
  "ai_analysis": {
    "summary": "Great location and host, but slow shower drain.",
    "pros": ["Great location", "Start host"],
    "cons": ["Slow shower drain", "Hair on floor"],
    "tags": ["MAINTENANCE_URGENT", "CLEANLINESS_CRITICAL"],
    "sentiment_score": 0.45,
    "is_hidden_negative": true,
    "is_hidden_positive": false
  }
}

---

---

🤖 AI Intelligence

This Actor comes pre-configured with Advanced AI (GPT-4o / DeepSeek). You do not need to provide your own API Key.

The AI automatically:

1. Reads the review logic.
2. Detects hidden negatives.
3. Assigns operational tags.

All analysis costs are included in the Actor's usage.

---

---

💰 Cost & Pricing

This Actor is priced based on the number of reviews analyzed. You only pay for successful results. The price decreases significantly with higher Apify subscription plans (Bronze, Silver, Gold).

Apify Plan	Discount Level	Price per 1,000 Reviews	Cost per 1 Review
Free	No Discount	$5.00	$0.005
Starter	Bronze Discount	$4.10	$0.0041
Scale	Silver Discount	$3.20	$0.0032
Business	Gold Discount	$2.30	$0.0023

There is a nominal fee of ~$0.0001 to start the Actor run.

Example Calculation:

• If you analyze 100 reviews on the Free plan, it costs $0.50.
• If you analyze 1,000 reviews on the Scale plan, it costs $3.20.

---

🎯 Common Use Cases

1. Due Diligence: Investors analyzing a property before purchase.
2. Competitor Analysis: Property Managers analyzing why a competitor gets 5 stars.
3. Quality Control: Large PMs auditing their own portfolio for hidden maintenance issues.

---

❓ Troubleshooting

• Reviews not loading? Ensure you are using Residential Proxies. Datacenter proxies are blocked by Airbnb.
• Output is empty? Check if the Airbnb URL is correct and public. Private or deleted listings cannot be scraped.
• "Maintenance" or "Access Denied"? Airbnb may have updated their system. Please use the "Report Issue" tab, and we will update the internal API Hash almost immediately.

---

🤖 Automation & Integration Ideas

• Property Management: Automatically scan your entire portfolio weekly to catch "hidden negatives" before they become bad ratings.
• Investment Scouting: Feed a list of 100 potential investment properties to find the ones with "bad management" (high potential upside).
• Competitor Alerts: Connect to Slack/Discord to get notified when a competitor gets a complaint about cleanliness.
• CRM Enrichment: Push structured review data (Pros, Cons, Maintenance tags) directly into Airtable, HubSpot, or Monday.com.

---

🔌 Integrations & API Usage

You can run this Actor and integrate it with other systems programmatically by using the Apify API. You can also choose the language preference from the API tab of the Actor's page in the Apify Store. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

---

❓ FAQ

Q: Is a proxy required? A: Yes, absolutely. Airbnb has strict anti-scraping protections. You must use Residential Proxies (included in Apify Proxy "Residential" groups). Datacenter proxies will fail.

Q: Does it scrape all reviews? A: Yes, if you set maxReviews to 0, it will paginate through all available reviews for the listing.

Q: Is it legal to scrape reviews? A: Generally, yes. You are analyzing publicly available data. However, you must respect personal privacy (PII) and not use the data for spam/harassment. Read Apify's blog post on the legality of web scraping to learn more.

---

🧩 Known Limitations

• Login Walls: The Actor accesses public listing data only. It does not log in to user accounts.
• Exact Location: It scrapes the approximate location provided publicly by Airbnb, not the exact address (which is private until booking).

---

💬 Questions or Issues?

If you encounter problems or have feature requests, please open an issue on the Issues tab of the Actor's page in the Apify Store. We monitor them closely!

---

⚠️ Disclaimer

This Actor is for educational and data analysis purposes only. It is not affiliated with, endorsed by, or connected to Airbnb, Inc.

• Proxy Usage: Scraping Airbnb strictly requires Residential Proxies. Datacenter proxies will likely be blocked immediately.
• Respect Rate Limits: Do not scrape aggressively. This Actor includes built-in delays to mimic human behavior.