# Hotel & Restaurant Reputation Report (Google Reviews) (`inforwebpyme/hotel-reputation-report`) Actor

Reputation report for any hotel or restaurant worldwide, from public Google reviews: what guests praise and criticize, trends and competitor comparison. In English or Spanish. / Informe de reputacion de tu hotel o restaurante con resenas de Google: elogios, criticas y comparativa.

- **URL**: https://apify.com/inforwebpyme/hotel-reputation-report.md
- **Developed by:** [Miguel Romero Luzardo](https://apify.com/inforwebpyme) (community)
- **Categories:** Marketing, Travel
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1,000.00 / 1,000 informe de reputación del negocios

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Informe de reputación de hoteles y restaurantes (reseñas de Google)

Indica tu hotel o restaurante (y, si quieres, a tus competidores) y obtén un **informe de reputación online, listo para un gerente** (en español o en inglés), a partir de las reseñas públicas de Google:

- Qué elogian los clientes y qué critican, con ejemplos.
- Qué mejora y qué empeora respecto al periodo anterior.
- Comparativa con la competencia de tu zona.
- 3 acciones recomendadas para esta semana.

Funciona con cualquier hotel o restaurante del mundo que tenga reseñas en Google. El informe puede generarse en español o en inglés.

### Cómo se usa

1. Escribe el nombre y la localidad de tu negocio (o pega el enlace de Google Maps).
2. Opcional: añade hasta 5 competidores. Si no, el Actor busca los más comentados de la zona.
3. Ejecuta. Programa una ejecución semanal en Schedules para recibir el informe cada semana, y conecta una integración (correo, Slack, Google Sheets) para recibirlo automáticamente.

### Salida

- Dataset: cifras y el informe en Markdown (`informeMarkdown`).
- Almacén clave-valor: `INFORME.md`, listo para copiar en un correo.

### Análisis de reseñas con datos agregados y privacidad

Solo se leen reseñas públicas y se usan datos agregados. No se guardan nombres ni datos personales de los autores de las reseñas.

### Precio

Pago por evento: un cargo por informe de negocio y otro por cada competidor comparado. Incluye la lectura de reseñas y el análisis con IA.

### Notas

- La IA puede equivocarse: el informe se apoya solo en las reseñas leídas y las cifras se calculan por separado.
- Opcional: puedes usar tu propia clave de IA compatible con OpenAI.

### In English

Online reputation report for hotels and restaurants, built from public Google reviews: what guests praise and criticize, trends vs. the previous period, comparison with local competitors and 3 recommended actions. Weekly schedulable. Reports in English or Spanish - works with any hotel or restaurant worldwide with Google reviews.

### Otros Actors del mismo autor

- [Alertas de licitaciones públicas - España (PLACSP) y Europa (TED)](https://apify.com/inforwebpyme/placsp-licitaciones-alertas)
- [Alertas de subvenciones y ayudas públicas de España (BDNS)](https://apify.com/inforwebpyme/bdns-subvenciones-alertas)

# Actor input Schema

## `negocio` (type: `string`):

Ejemplo: Hotel Riu Palace Maspalomas, Gran Canaria. Vale cualquier ciudad del mundo. También puedes pegar el enlace de Google Maps.

## `competidores` (type: `array`):

Nombre y localidad, o enlace de Google Maps, de cada competidor. Hasta 5.

## `buscarCompetidoresAutomaticamente` (type: `boolean`):

Si no indicas competidores, el Actor busca los hoteles más comentados de la misma zona.

## `numeroCompetidoresAuto` (type: `integer`):

Entre 1 y 5.

## `diasRecientes` (type: `integer`):

El informe compara este periodo con el anterior (por defecto 30 días vs. los 60 anteriores).

## `maxResenasPorNegocio` (type: `integer`):

Se leen las más recientes. Más reseñas = informe más sólido, pero más coste de lectura.

## `idiomaInforme` (type: `string`):

El análisis lee reseñas en cualquier idioma; el informe se redacta en el idioma elegido.

## `modeloIA` (type: `string`):

Modelo usado para redactar el informe (a través de Apify). Déjalo por defecto si no estás seguro.

## `claveIAPropia` (type: `string`):

Si pones una clave compatible con OpenAI, el Actor la usa en lugar de la IA de Apify.

## `urlBaseIAPropia` (type: `string`):

Solo si usas clave propia. Ejemplo: https://api.openai.com/v1

## Actor input object example

```json
{
  "negocio": "Hotel Riu Palace Maspalomas, Gran Canaria",
  "competidores": [],
  "buscarCompetidoresAutomaticamente": true,
  "numeroCompetidoresAuto": 3,
  "diasRecientes": 30,
  "maxResenasPorNegocio": 150,
  "idiomaInforme": "es",
  "modeloIA": "google/gemini-2.5-flash",
  "urlBaseIAPropia": "https://api.openai.com/v1"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "negocio": "Hotel Riu Palace Maspalomas, Gran Canaria",
    "competidores": [],
    "idiomaInforme": "es"
};

// Run the Actor and wait for it to finish
const run = await client.actor("inforwebpyme/hotel-reputation-report").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "negocio": "Hotel Riu Palace Maspalomas, Gran Canaria",
    "competidores": [],
    "idiomaInforme": "es",
}

# Run the Actor and wait for it to finish
run = client.actor("inforwebpyme/hotel-reputation-report").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "negocio": "Hotel Riu Palace Maspalomas, Gran Canaria",
  "competidores": [],
  "idiomaInforme": "es"
}' |
apify call inforwebpyme/hotel-reputation-report --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,inforwebpyme/hotel-reputation-report"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/BAdhfFBr7HlDycuWz/builds/XNTlbkvfp7c2YC7Pd/openapi.json