# Hoteles Listing Scraper

Extract data of hotels from Hoteles by URL with Checkin-Checkout Date

- Template page: [https://www.octoparse.com/template/hoteles-listados-scraper](https://www.octoparse.com/template/hoteles-listados-scraper)
- Categories: Travel
- Status: `PUBLISHED`
- Run mode: `LOCAL`

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

## Output

The current workflow extracts 13 fields, including `nombre`, `URL`, `n_estrellas`, `direccion`, `Servicios_populares`, `descripción`, `Reembolsa_Sello`, `puntuacion`, `n_comentario`, `Precio`, `Precio_Original`, `Precio_unitario`, `Fecha`.

## 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 URLs of listing pages with checkin & checkout dates and start the template in local mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URLs of listing pages with checkin & checkout dates

Required. URL of listing pages with checkin & checkout dates Constraints: minItems=1; maxItems=11000; items.minLength=1; items.maxLength=10000.

## How to Use

## Hoteles Listing Scraper

Collects data of hotels from Hoteles by URL with Checkin‑Checkout Date.  
Data source: [Hoteles](https://es.hoteles.com/).

### Input

- **URLs of listing pages with checkin & checkout dates** (required) – one per line.

### Output Fields

- `nombre`
- `URL`
- `n_estrellas`
- `direccion`
- `Servicios_populares`
- `descripción`
- `Reembolsa_Sello`
- `puntuacion`
- `n_comentario`
- `Precio`
- `Precio_Original`
- `Precio_unitario`
- `Fecha`

### How to Use

1. Open the template and select **Try it** or **Start**.
2. Enter one or more listing‑page URLs with checkin and checkout dates.
3. Run the task locally.
4. Review the output rows. Export to CSV, Excel, JSON, or use Octoparse APIs.

### Limitations

- Runs locally; keep computer and Octoparse open while the task runs.
- Fields (`Precio_Original`, `Precio_unitario`, `Fecha`) may be empty if the source does not provide them.
- Scheduling and API access may require a paid Octoparse plan.

### Tips

- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid URLs of listing pages with checkin & checkout dates to reduce unrelated or duplicate records.
- Use a stable identifier (`nombre`, `URL`, etc.) as a deduplication key when available.

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

- [Hoteles Details Scraper](https://www.octoparse.com/template/hoteles-detalles-scraper)
- [Booking.com Hotel Listing Scraper](https://www.octoparse.com/template/booking-com-scraper)
- [Google Maps Store Listing Scraper (Japan)](https://www.octoparse.com/template/google-maps-store-listing-scraper)
- [Zillow Listing Scraper (by URL)](https://www.octoparse.com/template/zillow-scraper)
- [Mercadolibre Listing Pages Scraper (Keywords)](https://www.octoparse.com/template/mercadolibre-listados-scraper)

## Input Schema

```json
{
  "title": "Hoteles Listing Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRLs_of_listing_pages_with_checkin_&_checkout_dates": {
      "title": "URLs of listing pages with checkin & checkout dates",
      "description": "URL of listing pages with checkin & checkout dates",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 11000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRLs_of_listing_pages_with_checkin_&_checkout_dates"
  ]
}
```

## Input JSON Example

No verified real input/output examples are currently available.


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "nombre": {
      "type": "string",
      "description": ""
    },
    "URL": {
      "type": "string",
      "description": ""
    },
    "n_estrellas": {
      "type": "string",
      "description": ""
    },
    "direccion": {
      "type": "string",
      "description": ""
    },
    "Servicios_populares": {
      "type": "string",
      "description": ""
    },
    "descripción": {
      "type": "string",
      "description": ""
    },
    "Reembolsa_Sello": {
      "type": "string",
      "description": ""
    },
    "puntuacion": {
      "type": "string",
      "description": ""
    },
    "n_comentario": {
      "type": "string",
      "description": ""
    },
    "Precio": {
      "type": "string",
      "description": ""
    },
    "Precio_Original": {
      "type": "string",
      "description": ""
    },
    "Precio_unitario": {
      "type": "string",
      "description": ""
    },
    "Fecha": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Hoteles Listing Scraper 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

No verified real input/output examples are currently available.

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

No verified real input/output examples are currently available.

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `hoteles-listados-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/hoteles-listados-scraper.json)
- [Manifest](https://www.octoparse.com/templates/hoteles-listados-scraper-manifest.json)