Otelpuan Reviews Scraper

Extract hotel reviews from Otelpuan using a hotel page URL or vendor ID.

Ideal for reputation monitoring and hospitality analytics focused on the Turkish market.

What you get

• Hotel name, aggregate rating, and review count
• Review title and body
• Overall score on Otelpuan’s 10-point scale, plus category scores
• Author name and avatar
• Travel / booking period and room type
• Recommendation and channel
• Owner reply text and date
• Photos (when available)
• Full raw review object for advanced use

How to use

1. Open this Actor and click Start
2. Add Otelpuan hotel URLs under Hotel URLs, or paste vendor IDs under Vendor IDs
3. Set Max reviews per hotel (0 = all)
4. Run and download results from the Dataset tab

Finding the vendor ID

• From an Otelpuan hotel page, the Actor reads data-hd-vendorId automatically
• Or pass the numeric vendor ID directly

Input example

{
  "startUrls": [
    { "url": "https://www.otelpuan.com/Concorde-De-Luxe-Resort" }
  ],
  "maxReviews": 100
}

Or with a vendor ID:

{
  "vendorIds": ["12345"],
  "maxReviews": 100
}

Output example

Each dataset item is one review:

{
  "reviewId": "4956089",
  "vendorId": "25545",
  "hotelName": "Example Hotel",
  "title": "Otel çok güzel ve temizdi.",
  "text": "Oda harikaydı. 24 saat yeme-içme imkanı vardı.",
  "rating": 10,
  "ratingScale": 10,
  "authorName": "S*** K***",
  "travelDate": "2025-09-01T00:00:00.000Z",
  "roomTypeName": "COURTYARD SUITE",
  "recommendation": "RECOMMEND",
  "replyText": "Teşekkür ederiz...",
  "source": "otelpuan",
  "scrapedAt": "2026-07-11T12:00:00.000Z"
}

A hotel summary is also saved in the key-value store as HOTEL_INFO_{vendorId}.

Tips

• Prefer Vendor IDs when you already know them — reviews are fetched via API and work reliably.
• Hotel URLs are useful when you need hotel name/rating metadata from the page; enable Apify Proxy if page fetches are blocked.
• Use maxReviews to control cost on hotels with many reviews.
• Ratings use a 1–10 scale (ratingScale: 10).
• Add multiple hotels in one run to batch scraping.

Limitations

• Only public Otelpuan hotel reviews are returned.
• Review text is typically in Turkish.