Hotel Reviews Aggregator API & MCP Server

Hotel Reviews Aggregator & MCP Server extracts hotel reviews from Google Travel and TripAdvisor.

It provides a REST API endpoint for applications and a Model Context Protocol (MCP) endpoint for AI assistants such as Claude Desktop, Cursor, and custom AI agents.

---

Use Cases

• Competitor Analysis: Benchmark guest ratings, review volume, and customer feedback against competing hotels.
• Data Analytics and Research: Collect structured review datasets for market research, sentiment analysis, and reporting.
• AI Agent Integration: Supply real-time hotel review data directly to AI agents, chatbots, and research workflows.
• ERP and CRM Integration: Connect review data directly into internal ERP systems, CRM platforms, and hospitality dashboards.
• Brand Protection: Track reviews across platforms to identify emerging issues and customer satisfaction trends.

---

Features

• Dual Platform Coverage: Extract reviews from both Google Travel and TripAdvisor.
• Built-in MCP Server: Native support for Model Context Protocol using the tool get_hotel_reviews.
• Standby Mode: Fast responses without startup delays.
• Proxy Rotation: Automatically rotates IP addresses to avoid rate limits and blocks.
• Pagination: Easily fetch large numbers of reviews using next_page_token.
• Pay-Per-Event Pricing: Pay only for valid review requests.

---

Extracted Data

Each review returned includes the following fields:

• Rating: Star rating given by the reviewer.
• Review Text: Text content of the review.
• Author Information: Reviewer name and profile details.
• Publish Date: Review date in ISO format.
• Platform: Source platform (google or tripadvisor).

---

How to Use

1. REST API (POST /api/reviews)

Send an HTTP POST request to your Standby Actor endpoint:

curl -X POST "https://<YOUR-STANDBY-URL>/api/reviews?token=<YOUR-APIFY-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "google",
    "url": "https://www.google.com/travel/hotels/entity/..."
  }'

Request Parameters

Parameter	Type	Required	Description
source	string	Yes	Target platform (google or tripadvisor).
url	string	Yes	Full hotel page URL on Google Travel or TripAdvisor.
next_page	string	No	Pagination token returned from a previous request.

Sample Response

{
  "platform": "google",
  "source_url": "https://www.google.com/travel/hotels/entity/...",
  "next_page_token": "CAESB0dPT0dMR...",
  "reviews": [
    {
      "author": "John Doe",
      "rating": 5,
      "text": "Great service and beautiful rooms!",
      "date": "2026-07-20"
    }
  ]
}

---

2. Model Context Protocol (MCP) Server (POST /mcp)

Connect this Actor as an MCP Server tool to AI applications.

Tool Definition

• Tool Name: get_hotel_reviews
• Description: Fetches a page of hotel reviews from Google or TripAdvisor for a given URL.

MCP Client Configuration (claude_desktop_config.json / Cursor)

{
  "mcpServers": {
    "hotel-reviews": {
      "url": "https://<YOUR-STANDBY-URL>/mcp?token=<YOUR-APIFY-TOKEN>"
    }
  }
}

---

Pricing

You pay only for successful requests:

• REST API Review Fetch (POST /api/reviews): $0.003 per request.
• MCP Tool Call (get_hotel_reviews): $0.003 per tool call.

Invalid requests with missing required parameters are not charged.

---

Platform Features

• Automatic Proxy Rotation: Handles IP rotation automatically.
• Standby Server: Stays online to respond to requests continuously.
• Monitoring and Logs: View request metrics and error logs in the Apify Console.

---

Support

If you run into issues or have questions, submit an issue in the Issues tab on Apify Store.