# TripAdvisor Scraper (Hotel Details)

Scrape hotel details (hotel name, ranking, location, etc.) from Tripadvisor by URL.

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

## Pricing

Current price: **$1.5/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

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

## Output

The current workflow extracts 20 fields, including `Web_Page_URL`, `Hotel_Name`, `Number_of_Reviews`, `Ranking`, `Location`, `Phone_Number`, `Property_Amenities`, `Room_Features`, `Star_Rating`, `Location_Rating`, `Cleanliness_Rating`, `Service_Rating`, `Value_Rating`, `Great_for_Walkers`, `Number_of_Restaurants`, `Number_of_Attractions`, `Current_Time`, `Image_1`, `Image_2`, `Image_3`.

## 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 Hotel URLs (Up to 100) and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Hotel URLs (Up to 100)

Required. Hotel URLs (Up to 100) Constraints: minItems=1; maxItems=100; items.minLength=1; items.maxLength=1000000.

## How to Use

# Tripadvisor Hotel Details Scraper

This template accepts hotel detail-page URLs and returns property name, price, rating, review count, amenities, and the detail-page URL. Data is collected from [Tripadvisor Hotels](https://www.tripadvisor.com/Hotels).

## Pricing

**$1.5 per 1,000 lines** – billed on output lines.

## Input

- **Hotel URLs** (Required) – up to 100 entries per run.

## How to Use

1. Open the template and click **Try it!**.
2. Enter **Hotel URLs** (one per line, up to 100).
3. Run the task in the Octoparse cloud.
4. Export the output. The dataset includes fields such as `Hotel_Name`, `Detail_Page_URL`, `Price`, `Current_Time`, and `content`.

## Tips

- Test one representative URL first before submitting a large batch.
- Keep `Detail_Page_URL` in your export to trace each row back to its input.

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

- [TripAdvisor Hotel Reviews Scraper](https://www.octoparse.com/template/tripadvisor-hotel-reviews-scraper)
- [Tripadvisor Hotel Details Scraper](https://www.octoparse.com/template/tripadvisor-hotel-detalles-scraper)
- [TripAdvisor Scraper (Hotel Listing)](https://www.octoparse.com/template/tripadvisor-scraper-hotel-listing)
- [TripAdvisor Hotel Review Scraper (for Italy)](https://www.octoparse.com/template/crawler-recensioni-hotel-tripadvisor)
- [TripAdvisor Hotel Detail Scraper (for Italy)](https://www.octoparse.com/template/crawler-dettagli-hotel-tripadvisor)

## Input Schema

```json
{
  "title": "TripAdvisor Scraper (Hotel Details) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "hotel_URLs": {
      "title": "Hotel URLs (Up to 100)",
      "description": "Hotel URLs (Up to 100)",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1000000
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "hotel_URLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "hotel_URLs": [
    "https://www.tripadvisor.com/Hotel_Review-g1114493-d1145552-Reviews-Island_Inn_Rishiri-Rishiri_cho_Rishiri_gun_Rishiri_to_Hokkaido.html"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Web_Page_URL": {
      "type": "string",
      "description": ""
    },
    "Hotel_Name": {
      "type": "string",
      "description": ""
    },
    "Number_of_Reviews": {
      "type": "string",
      "description": ""
    },
    "Ranking": {
      "type": "string",
      "description": ""
    },
    "Location": {
      "type": "string",
      "description": ""
    },
    "Phone_Number": {
      "type": "string",
      "description": ""
    },
    "Property_Amenities": {
      "type": "string",
      "description": ""
    },
    "Room_Features": {
      "type": "string",
      "description": ""
    },
    "Star_Rating": {
      "type": "string",
      "description": ""
    },
    "Location_Rating": {
      "type": "string",
      "description": ""
    },
    "Cleanliness_Rating": {
      "type": "string",
      "description": ""
    },
    "Service_Rating": {
      "type": "string",
      "description": ""
    },
    "Value_Rating": {
      "type": "string",
      "description": ""
    },
    "Great_for_Walkers": {
      "type": "string",
      "description": ""
    },
    "Number_of_Restaurants": {
      "type": "string",
      "description": ""
    },
    "Number_of_Attractions": {
      "type": "string",
      "description": ""
    },
    "Current_Time": {
      "type": "string",
      "description": ""
    },
    "Image_1": {
      "type": "string",
      "description": ""
    },
    "Image_2": {
      "type": "string",
      "description": ""
    },
    "Image_3": {
      "type": "string",
      "description": ""
    }
  },
  "title": "TripAdvisor Scraper (Hotel Details) 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
{
  "Web_Page_URL": "https://www.tripadvisor.com/Hotel_Review-g1114493-d1145552-Reviews-Island_Inn_Rishiri-Rishiri_cho_Rishiri_gun_Rishiri_to_Hokkaido.html",
  "Hotel_Name": "Island Inn Rishiri",
  "Number_of_Reviews": "(68 reviews)",
  "Ranking": "#1 of 2 hotels in Rishiri-cho",
  "Location": "30 Kutsugata Fujimicho, Rishiri-cho, Rishiri-gun 097-0401 Hokkaido",
  "Phone_Number": "",
  "Property_Amenities": "Free parking,Restaurant,Bicycle rental,Hiking,Airport transportation,Hot spring bath,24-hour security,Baggage storage",
  "Room_Features": "Air conditioning,Desk,Housekeeping,Safe,Sofa,Refrigerator,Bath / shower,Complimentary toiletries",
  "Star_Rating": "4.2",
  "Location_Rating": "3.8",
  "Cleanliness_Rating": "4.6",
  "Service_Rating": "4.2",
  "Value_Rating": "3.8",
  "Great_for_Walkers": "69",
  "Number_of_Restaurants": "20 Restaurants",
  "Number_of_Attractions": "4 Attractions",
  "Current_Time": "2026-09-15 02:13:54.052609",
  "Image_1": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/0a/a9/44/75/caption.jpg?w=900&h=500&s=1",
  "Image_2": "https://dynamic-media-cdn.tripadvisor.com/media/photo-s/01/b3/45/93/caption.jpg?w=300&h=-1&s=1",
  "Image_3": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/1d/6e/71/12/caption.jpg?w=300&h=-1&s=1"
}
```

## 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": "tripadvisor-scraper-hotel-details",
  "taskName": "TripAdvisor Scraper (Hotel Details)",
  "parameters": "{\"hotel_URLs\":[\"https://www.tripadvisor.com/Hotel_Review-g1114493-d1145552-Reviews-Island_Inn_Rishiri-Rishiri_cho_Rishiri_gun_Rishiri_to_Hokkaido.html\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"hotel_URLs\":[\"https://www.tripadvisor.com/Hotel_Review-g1114493-d1145552-Reviews-Island_Inn_Rishiri-Rishiri_cho_Rishiri_gun_Rishiri_to_Hokkaido.html\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "tripadvisor-scraper-hotel-details",
        "taskName": "TripAdvisor Scraper (Hotel Details)",
        "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": "tripadvisor-scraper-hotel-details",
  "taskName": "TripAdvisor Scraper (Hotel Details)",
  "parameters": "{\"hotel_URLs\":[\"https://www.tripadvisor.com/Hotel_Review-g1114493-d1145552-Reviews-Island_Inn_Rishiri-Rishiri_cho_Rishiri_gun_Rishiri_to_Hokkaido.html\"]}"
}
JSON
```

## MCP Setup

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