# Booking Review Scraper for Spain

Extract review data from Booking Spain

- Template page: [https://www.octoparse.com/template/booking-resena-scraper](https://www.octoparse.com/template/booking-resena-scraper)
- Categories: Travel
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from general web pages.

## Output

The current workflow extracts 17 fields, including `Buenos`, `Calificación`, `Calificación_Personal`, `Cantidad_de_Comentario`, `Fecha_de_comentario`, `Hotel`, `Instalaciones_de_servicios`, `Malos`, `Nombre`, `Personal`, `Personas`, `Resumen`, `WIFI_Gratis`, `confort`, `limpieza`, `relación_calidad-precio`, `ubicación`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Keywords(up to 100) and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Keywords(up to 100)

Required. MainKeys Constraints: minItems=1; maxItems=1000; items.minLength=1; items.maxLength=10000.

## How to Use

# Booking Review Scraper for Spain

Collects review data from [Booking.com](https://www.booking.com/) (Spain).

## Pricing

No per‑line charge.

## Input

- **Keywords (up to 100)** (required) – Enter one or more values, one per line.

## How to Use

1. Open the template and select **Try it** or **Start**.
2. Complete the input fields above.
3. Run the task in the cloud.
4. Review the output rows and export or process the structured data.

## Output

The template returns review fields including hotel name, overall rating, number of reviews, scores for staff, facilities, cleanliness, comfort, value, location, free WiFi, reviewer name, review date, traveler type, personal rating, summary, and pros/cons text.

## Limitations

- Only collects data that Booking.com displays on the review pages.
- Fields such as summary, pros, and cons may be empty when the source does not provide them.

## Tips

- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid keywords to reduce unrelated or duplicate records.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Booking Hotel Listing Scraper (for germany)](https://www.octoparse.com/template/booking-hotel-listing-scraper-for-germany)
- [Booking.com Listing Scraper (for Spain)](https://www.octoparse.com/template/booking-hotel-listados-scraper)
- [Booking Details Scraper for Spanish](https://www.octoparse.com/template/booking-hotel-detalles-scraper)
- [Amazon Product Listing Scraper(for Spain)](https://www.octoparse.com/template/amazon-espana-listados-scraper)
- [Amazon Product Details Scraper (for Spain)](https://www.octoparse.com/template/amazon-producto-detalles-scraper-asin)

## Input Schema

```json
{
  "title": "Booking Review Scraper for Spain input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "keywords": {
      "title": "Keywords(up to 100)",
      "description": "MainKeys",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "keywords"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "keywords": [
    "https://www.booking.com/hotel/es/h10-imperial-tarraco.es.html?label=tarragona&aid=378519&ucfs=1&arphpl=1&checkin=2024-11-01&checkout=2024-11-03&dest_id=-403902&dest_type=city&group_adults=2&req_adults=2&no_rooms=1&group_children=0&req_children=0&hpos=1&hapos=1&sr_order=popularity&nflt=hotelfacility%3D&srpvid=45d92f2ef43e007f&srepoch=1724222582&all_sr_blocks=584657218_238516000_0_2_0_234037&highlighted_blocks=584657218_238516000_0_2_0_234037&matching_block_id=584657218_238516000_0_2_0_234037&sr_pri_blocks=584657218_238516000_0_2_0_234037_25528&from_sustainable_property_sr=1&from=searchresults#hotelTmpl"
  ]
}
```

Example 2

```json
{
  "keywords": [
    "https://www.booking.com/hotel/es/h10-imperial-tarraco.es.html?label=tarragona&aid=378519&ucfs=1&arphpl=1&checkin=2024-11-01&checkout=2024-11-03&dest_id=-403902&dest_type=city&group_adults=2&req_adults=2&no_rooms=1&group_children=0&req_children=0&hpos=1&hapos=1&sr_order=popularity&nflt=hotelfacility%3D&srpvid=45d92f2ef43e007f&srepoch=1724222582&all_sr_blocks=584657218_238516000_0_2_0_234037&highlighted_blocks=584657218_238516000_0_2_0_234037&matching_block_id=584657218_238516000_0_2_0_234037&sr_pri_blocks=584657218_238516000_0_2_0_234037_25528&from_sustainable_property_sr=1&from=searchresults#hotelTmpl"
  ]
}
```

Example 3

```json
{
  "keywords": [
    "https://www.booking.com/hotel/es/h10-imperial-tarraco.es.html?label=tarragona&aid=378519&ucfs=1&arphpl=1&checkin=2024-11-01&checkout=2024-11-03&dest_id=-403902&dest_type=city&group_adults=2&req_adults=2&no_rooms=1&group_children=0&req_children=0&hpos=1&hapos=1&sr_order=popularity&nflt=hotelfacility%3D&srpvid=45d92f2ef43e007f&srepoch=1724222582&all_sr_blocks=584657218_238516000_0_2_0_234037&highlighted_blocks=584657218_238516000_0_2_0_234037&matching_block_id=584657218_238516000_0_2_0_234037&sr_pri_blocks=584657218_238516000_0_2_0_234037_25528&from_sustainable_property_sr=1&from=searchresults#hotelTmpl"
  ]
}
```

Example 4

```json
{
  "keywords": [
    "https://www.booking.com/hotel/es/h10-imperial-tarraco.es.html?label=tarragona&aid=378519&ucfs=1&arphpl=1&checkin=2024-11-01&checkout=2024-11-03&dest_id=-403902&dest_type=city&group_adults=2&req_adults=2&no_rooms=1&group_children=0&req_children=0&hpos=1&hapos=1&sr_order=popularity&nflt=hotelfacility%3D&srpvid=45d92f2ef43e007f&srepoch=1724222582&all_sr_blocks=584657218_238516000_0_2_0_234037&highlighted_blocks=584657218_238516000_0_2_0_234037&matching_block_id=584657218_238516000_0_2_0_234037&sr_pri_blocks=584657218_238516000_0_2_0_234037_25528&from_sustainable_property_sr=1&from=searchresults#hotelTmpl"
  ]
}
```

Example 5

```json
{
  "keywords": [
    "https://www.booking.com/hotel/es/h10-imperial-tarraco.es.html?label=tarragona&aid=378519&ucfs=1&arphpl=1&checkin=2024-11-01&checkout=2024-11-03&dest_id=-403902&dest_type=city&group_adults=2&req_adults=2&no_rooms=1&group_children=0&req_children=0&hpos=1&hapos=1&sr_order=popularity&nflt=hotelfacility%3D&srpvid=45d92f2ef43e007f&srepoch=1724222582&all_sr_blocks=584657218_238516000_0_2_0_234037&highlighted_blocks=584657218_238516000_0_2_0_234037&matching_block_id=584657218_238516000_0_2_0_234037&sr_pri_blocks=584657218_238516000_0_2_0_234037_25528&from_sustainable_property_sr=1&from=searchresults#hotelTmpl"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Buenos": {
      "type": "string",
      "description": ""
    },
    "Calificación": {
      "type": "string",
      "description": ""
    },
    "Calificación_Personal": {
      "type": "string",
      "description": ""
    },
    "Cantidad_de_Comentario": {
      "type": "string",
      "description": ""
    },
    "Fecha_de_comentario": {
      "type": "string",
      "description": ""
    },
    "Hotel": {
      "type": "string",
      "description": ""
    },
    "Instalaciones_de_servicios": {
      "type": "string",
      "description": ""
    },
    "Malos": {
      "type": "string",
      "description": ""
    },
    "Nombre": {
      "type": "string",
      "description": ""
    },
    "Personal": {
      "type": "string",
      "description": ""
    },
    "Personas": {
      "type": "string",
      "description": ""
    },
    "Resumen": {
      "type": "string",
      "description": ""
    },
    "WIFI_Gratis": {
      "type": "string",
      "description": ""
    },
    "confort": {
      "type": "string",
      "description": ""
    },
    "limpieza": {
      "type": "string",
      "description": ""
    },
    "relación_calidad-precio": {
      "type": "string",
      "description": ""
    },
    "ubicación": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Booking Review Scraper for Spain output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Buenos": "Hotel limpio, cómodo y super bien ubicado. El personal es muy atento y nos indicaron y ayudaron con todo super bien. El desayuno está muy rico y completo. La terraza de arriba es chulísima. 100% recomendable.",
  "Calificación": "9",
  "Calificación_Personal": "10",
  "Cantidad_de_Comentario": "4",
  "Fecha_de_comentario": "Fecha del comentario: 5 de mayo de 2025",
  "Hotel": "H10 Imperial Tarraco 4 Sup",
  "Instalaciones_de_servicios": "9,3",
  "Malos": "El precio del parking son 24€/día un poco caro y el desayuno son 20€/persona, esta muy rico pero algo caro.",
  "Nombre": "",
  "Personal": "9,3",
  "Personas": "En pareja",
  "Resumen": "Buen hotel en Tarragona. Muy recomendable.",
  "WIFI_Gratis": "9,3",
  "confort": "9,3",
  "limpieza": "9,3",
  "relación_calidad-precio": "9,3",
  "ubicación": "9,3"
}
```

Example 2

```json
{
  "Buenos": "La ubicación, las vistas y la habitación. El personal también muy amable.",
  "Calificación": "9",
  "Calificación_Personal": "9,0",
  "Cantidad_de_Comentario": "4",
  "Fecha_de_comentario": "Fecha del comentario: 22 de agosto de 2026",
  "Hotel": "H10 Imperial Tarraco 4 Sup",
  "Instalaciones_de_servicios": "9,3",
  "Malos": "La piscina de la azotea muy bonita pero pequeña y llena, no conseguimos hamacas o asientos para todos. Supongo que agosto tiene estas cosas. La de abajo también me pareció pequeña para un hotel tan grande.",
  "Nombre": "Carme",
  "Personal": "9,3",
  "Personas": "Persona que viaja sola",
  "Resumen": "Habitación cómoda y con vistas",
  "WIFI_Gratis": "9,3",
  "confort": "9,3",
  "limpieza": "9,3",
  "relación_calidad-precio": "9,3",
  "ubicación": "9,3"
}
```

Example 3

```json
{
  "Buenos": "Ubicación excelente. Tranquilidad, personal fantástico, buenas instalaciones",
  "Calificación": "9",
  "Calificación_Personal": "10",
  "Cantidad_de_Comentario": "4",
  "Fecha_de_comentario": "Fecha del comentario: 13 de agosto de 2026",
  "Hotel": "H10 Imperial Tarraco 4 Sup",
  "Instalaciones_de_servicios": "9,3",
  "Malos": "El acceso a la playa no era demasiado cómodo",
  "Nombre": "Isabel",
  "Personal": "9,3",
  "Personas": "En pareja",
  "Resumen": "Fantástico!",
  "WIFI_Gratis": "9,3",
  "confort": "9,3",
  "limpieza": "9,3",
  "relación_calidad-precio": "9,3",
  "ubicación": "9,3"
}
```

Example 4

```json
{
  "Buenos": "Todo: ubicación, amplitud de la habitación -cogimos una con balcón y vistas al mar-, limpieza, las dos piscinas, los restaurantes, el buffet desayuno y, sobre todo, la amabilidad del personal. \nMi cumpleaños coincidió con la estancia allí y me dejaron en la habitación una botella de cava. Todo un detalle",
  "Calificación": "9",
  "Calificación_Personal": "10",
  "Cantidad_de_Comentario": "4",
  "Fecha_de_comentario": "Fecha del comentario: 5 de agosto de 2026",
  "Hotel": "H10 Imperial Tarraco 4 Sup",
  "Instalaciones_de_servicios": "9,3",
  "Malos": "Nada",
  "Nombre": "Raquel",
  "Personal": "9,3",
  "Personas": "En familia",
  "Resumen": "Nuestra casa en Tarragona",
  "WIFI_Gratis": "8,7",
  "confort": "9,4",
  "limpieza": "9,4",
  "relación_calidad-precio": "8,7",
  "ubicación": "9,7"
}
```

Example 5

```json
{
  "Buenos": "La piscina en la azotea",
  "Calificación": "9",
  "Calificación_Personal": "9,0",
  "Cantidad_de_Comentario": "4",
  "Fecha_de_comentario": "Fecha del comentario: 30 de julio de 2026",
  "Hotel": "H10 Imperial Tarraco 4 Sup",
  "Instalaciones_de_servicios": "9,3",
  "Malos": "Nada en concreto",
  "Nombre": "Elena",
  "Personal": "9,3",
  "Personas": "Persona que viaja sola",
  "Resumen": "Escapada fin de semana",
  "WIFI_Gratis": "8,7",
  "confort": "9,4",
  "limpieza": "9,4",
  "relación_calidad-precio": "8,7",
  "ubicación": "9,7"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "booking-resena-scraper",
  "taskName": "Booking Review Scraper for Spain",
  "parameters": "{\"keywords\":[\"https://www.booking.com/hotel/es/h10-imperial-tarraco.es.html?label=tarragona&aid=378519&ucfs=1&arphpl=1&checkin=2024-11-01&checkout=2024-11-03&dest_id=-403902&dest_type=city&group_adults=2&req_adults=2&no_rooms=1&group_children=0&req_children=0&hpos=1&hapos=1&sr_order=popularity&nflt=hotelfacility%3D&srpvid=45d92f2ef43e007f&srepoch=1724222582&all_sr_blocks=584657218_238516000_0_2_0_234037&highlighted_blocks=584657218_238516000_0_2_0_234037&matching_block_id=584657218_238516000_0_2_0_234037&sr_pri_blocks=584657218_238516000_0_2_0_234037_25528&from_sustainable_property_sr=1&from=searchresults#hotelTmpl\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"keywords\":[\"https://www.booking.com/hotel/es/h10-imperial-tarraco.es.html?label=tarragona&aid=378519&ucfs=1&arphpl=1&checkin=2024-11-01&checkout=2024-11-03&dest_id=-403902&dest_type=city&group_adults=2&req_adults=2&no_rooms=1&group_children=0&req_children=0&hpos=1&hapos=1&sr_order=popularity&nflt=hotelfacility%3D&srpvid=45d92f2ef43e007f&srepoch=1724222582&all_sr_blocks=584657218_238516000_0_2_0_234037&highlighted_blocks=584657218_238516000_0_2_0_234037&matching_block_id=584657218_238516000_0_2_0_234037&sr_pri_blocks=584657218_238516000_0_2_0_234037_25528&from_sustainable_property_sr=1&from=searchresults#hotelTmpl\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "booking-resena-scraper",
        "taskName": "Booking Review Scraper for Spain",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "booking-resena-scraper",
  "taskName": "Booking Review Scraper for Spain",
  "parameters": "{\"keywords\":[\"https://www.booking.com/hotel/es/h10-imperial-tarraco.es.html?label=tarragona&aid=378519&ucfs=1&arphpl=1&checkin=2024-11-01&checkout=2024-11-03&dest_id=-403902&dest_type=city&group_adults=2&req_adults=2&no_rooms=1&group_children=0&req_children=0&hpos=1&hapos=1&sr_order=popularity&nflt=hotelfacility%3D&srpvid=45d92f2ef43e007f&srepoch=1724222582&all_sr_blocks=584657218_238516000_0_2_0_234037&highlighted_blocks=584657218_238516000_0_2_0_234037&matching_block_id=584657218_238516000_0_2_0_234037&sr_pri_blocks=584657218_238516000_0_2_0_234037_25528&from_sustainable_property_sr=1&from=searchresults#hotelTmpl\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `booking-resena-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/booking-resena-scraper.json)
- [Manifest](https://www.octoparse.com/templates/booking-resena-scraper-manifest.json)
