# Hotel Guest Reviews in Three Languages from HRS

**Use case:** 

Some HRS properties draw an international business crowd: this Hamburg waterfront hotel is reviewed in French, German and English in roughly equal measure. The 150 newest reviews with no language filter, each row carrying the language it was written in, so the corpus splits by market downstream - or set the languages filter to keep one. Cost: 150 review rows at $0.003 = at most $0.45 a run.

## Input

```json
{
  "startUrls": [],
  "hotelIds": [
    "390659"
  ],
  "maxReviewsPerHotel": 150,
  "reviewsSort": "most_recent",
  "travellerTypes": [],
  "languages": [],
  "maxRating": 0,
  "requireText": false,
  "language": "en",
  "includeHotelRow": true,
  "sessions": 4,
  "perIp": 1,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

## Output

```json
{
  "hotel_id": {
    "label": "Hotel id",
    "format": "string"
  },
  "hotel_name": {
    "label": "Hotel name",
    "format": "string"
  },
  "review_id": {
    "label": "Review id",
    "format": "string"
  },
  "rating": {
    "label": "Rating",
    "format": "number"
  },
  "rating_5": {
    "label": "Rating 5",
    "format": "number"
  },
  "recommends": {
    "label": "Recommends",
    "format": "boolean"
  },
  "positives": {
    "label": "Positives",
    "format": "string"
  },
  "negatives": {
    "label": "Negatives",
    "format": "string"
  },
  "hotel_reply": {
    "label": "Hotel reply",
    "format": "string"
  },
  "traveller_type": {
    "label": "Traveller type",
    "format": "string"
  },
  "age_group": {
    "label": "Age group",
    "format": "string"
  },
  "language": {
    "label": "Language",
    "format": "string"
  },
  "arrival_date": {
    "label": "Arrival date",
    "format": "string"
  },
  "departure_date": {
    "label": "Departure date",
    "format": "string"
  },
  "nights": {
    "label": "Nights",
    "format": "integer"
  },
  "review_date": {
    "label": "Review date",
    "format": "string"
  },
  "reviewer_name": {
    "label": "Reviewer name",
    "format": "string"
  },
  "votes": {
    "label": "Votes",
    "format": "object"
  },
  "url": {
    "label": "Url",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [HRS Reviews Scraper — Hotel Guest Reviews & Ratings](https://apify.com/kestrel/hrs-reviews-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/kestrel/hrs-reviews-scraper.md) to learn more, explore other use cases, and run it yourself.


## 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.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/kestrel/hrs-reviews-scraper.md

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).