# Tripadvisor Hotel Listings Scraper（for Japan）

Template for extracting hotel information (e.g. hotel name, price, rating or URL) from Tripadvisor via URLs.

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

## Pricing

Current price: **$0.1/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 listing pages.

## Output

The current workflow extracts 9 fields, including `ホテル名`, `ランキング`, `入力URL`, `取得日時`, `口コミ数`, `料金`, `星評価`, `設備_サービス`, `詳細ページURL`.

## 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 URL (up to 10 per run), check-in time (eg: 2026-01-20), check out time (eg: 2026-01-21) and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URL (up to 10 per run)

Required. hotel listing page URL Constraints: minItems=1; maxItems=10; items.minLength=1; items.maxLength=10000.

### check-in time (eg: 2026-01-20)

Required. Example: 2026-01-20 Constraints: minLength=1; maxLength=1000.

### check out time (eg: 2026-01-21)

Required. Example: 2026-01-21 Constraints: minLength=1; maxLength=1000.

### Number of pages (1~100)

Optional. number of pages Constraints: minimum=1, maximum=100.

## How to Use

# Tripadvisor Hotel Listings Scraper (for Japan)

Collects hotel listing data (e.g., hotel name, price, rating, URL) from [Tripadvisor](https://www.tripadvisor.com/) via URLs.

## Pricing

- Current price: **$0.1/1,000 lines**
- Billing is based on the number of output lines produced by the task.

## Output fields

- `ランキング`
- `ホテル名`
- `料金`
- `星評価`
- `口コミ数`
- `設備_サービス`
- `取得日時`
- `詳細ページURL`

Fields can be empty when the source record does not provide them.

## Input parameters

- **URL (up to 10 per run)** (required): Enter one or more values, one per line.
- **check-in time (eg: 2026-01-20)** (required): Enter the check-in time, e.g., `2026-01-20`.
- **check out time (eg: 2026-01-21)** (required): Enter the check-out time, e.g., `2026-01-21`.
- **Number of pages (1~100)** (optional): Enter a number from 1 to 100.

## How to use

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

## Notes and limitations

- Collects the fields listed above from listing pages; it does not add data that Tripadvisor does not display.
- Fields such as `設備_サービス`, `取得日時`, and `詳細ページURL` can be empty when the source record does not provide them.
- This template does not collect complete detail-page data; use a detail-page template when deeper record data is required.
- Start with one or a few inputs and review the returned rows before scaling the task.
- Use the most specific valid URL (up to 10 per run) to reduce unrelated or duplicate records.
- Use a stable URL or identifier from the output fields as the deduplication key when available.

## Scheduling and API access

- Run this template in the cloud without keeping a local computer online.
- Export rows to CSV, Excel, JSON, databases, or cloud storage, or send them to workflows through Octoparse APIs.
- Schedule recurring runs and use Octoparse OpenAPI or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates).
- Scheduling and API access may require a paid Octoparse plan.

## 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 Details Scraper（for Japan）](https://www.octoparse.com/template/tripadvisor-jp-hotel-details-scraper)
- [Tripadvisor Hotel Listing Scraper（for Spain）](https://www.octoparse.com/template/tripadvisor-hotel-listados-scraper)
- [Tripadvisor Hotel List Scraper (for Italy)](https://www.octoparse.com/template/crawler-lista-hotel-tripsdvisor)
- [Tripadvisor Hotel Scraper (for germany)](https://www.octoparse.com/template/tripadvisor-hotel-scraper-for-germany)
- [Tripadvisor Hotel Details Scraper](https://www.octoparse.com/template/tripadvisor-hotel-detalles-scraper)

## Input Schema

```json
{
  "title": "Tripadvisor Hotel Listings Scraper（for Japan） input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRL": {
      "title": "URL (up to 10 per run)",
      "description": "hotel listing page URL",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 10,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "check-in_time": {
      "title": "check-in time (eg: 2026-01-20)",
      "description": "Example:\n2026-01-20",
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "check_out_time": {
      "title": "check out time (eg: 2026-01-21)",
      "description": "Example:\n2026-01-21",
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "number_of_pages": {
      "title": "Number of pages (1~100)",
      "description": "number of pages",
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRL",
    "check-in_time",
    "check_out_time"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "check-in_time": "2027-01-25",
  "check_out_time": "2027-02-06",
  "number_of_pages": 28,
  "uRL": [
    "https://www.tripadvisor.jp/Hotels-g298236-Tokushima_Tokushima_Prefecture_Shikoku-Hotels.html"
  ]
}
```

Example 2

```json
{
  "check-in_time": "2026-09-09",
  "check_out_time": "2026-09-15",
  "number_of_pages": 14,
  "uRL": [
    "https://www.tripadvisor.jp/Hotels-g1023181-Tokyo_Prefecture_Kanto-Hotels.html"
  ]
}
```

Example 3

```json
{
  "check-in_time": "2026-09-08",
  "check_out_time": "2026-09-09",
  "number_of_pages": 1,
  "uRL": [
    "https://www.tripadvisor.jp/Hotels-g298143-Hokkaido-Hotels.html"
  ]
}
```

Example 4

```json
{
  "check-in_time": "2026-09-08",
  "check_out_time": "2026-09-09",
  "number_of_pages": 1,
  "uRL": [
    "https://www.tripadvisor.jp/Hotels-g298143-Hokkaido-Hotels.html"
  ]
}
```

Example 5

```json
{
  "check-in_time": "2026-07-25",
  "check_out_time": "2026-08-01",
  "number_of_pages": 20.0,
  "uRL": [
    "https://www.tripadvisor.jp/Hotels-g1023181-Tokyo_Prefecture_Kanto-Hotels.html"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "ホテル名": {
      "type": "string",
      "description": ""
    },
    "ランキング": {
      "type": "string",
      "description": ""
    },
    "入力URL": {
      "type": "string",
      "description": ""
    },
    "取得日時": {
      "type": "string",
      "description": ""
    },
    "口コミ数": {
      "type": "string",
      "description": ""
    },
    "料金": {
      "type": "string",
      "description": ""
    },
    "星評価": {
      "type": "string",
      "description": ""
    },
    "設備_サービス": {
      "type": "string",
      "description": ""
    },
    "詳細ページURL": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Tripadvisor Hotel Listings Scraper（for Japan） 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
{
  "ホテル名": "ビジネスホテル コスモス徳島",
  "ランキング": "24位：徳島市のホテル33軒中",
  "入力URL": "https://www.tripadvisor.jp/Hotels-g298236-Tokushima_Tokushima_Prefecture_Shikoku-Hotels.html",
  "取得日時": "2026-10-26 03:41:25",
  "口コミ数": "26",
  "料金": "￥10,825",
  "星評価": "3.5",
  "設備_サービス": "レストラン・飲食店 エアコン",
  "詳細ページURL": "https://www.tripadvisor.jp/Hotel_Review-g298236-d1082270-Reviews-Hotel_Cosmos_Tokushima-Tokushima_Tokushima_Prefecture_Shikoku.html"
}
```

Example 2

```json
{
  "ホテル名": "ヴィラフォンテーヌグランド東京汐留",
  "ランキング": "36位：港区のホテル144軒中",
  "入力URL": "https://www.tripadvisor.jp/Hotels-g1023181-Tokyo_Prefecture_Kanto-Hotels.html",
  "取得日時": "2026-09-18 02:55:01",
  "口コミ数": "1658",
  "料金": "￥15,676",
  "星評価": "4",
  "設備_サービス": "フィットネスセンター エアコン 無料Wi-Fi",
  "詳細ページURL": "https://www.tripadvisor.jp/Hotel_Review-g1066451-d609500-Reviews-Hotel_Villa_Fontaine_Grand_Tokyo_Shiodome-Minato_Tokyo_Tokyo_Prefecture_Kanto.html"
}
```

Example 3

```json
{
  "ホテル名": "JRタワーホテル日航札幌",
  "ランキング": "4位：札幌市のホテル175軒中",
  "入力URL": "https://www.tripadvisor.jp/Hotels-g298143-Hokkaido-Hotels.html",
  "取得日時": "2026-09-10 11:07:43",
  "口コミ数": "1895",
  "料金": "￥71,355",
  "星評価": "4.5",
  "設備_サービス": "エステ・マッサージ レストラン・飲食店 バー・ラウンジ エアコン",
  "詳細ページURL": "https://www.tripadvisor.jp/Hotel_Review-g298560-d302321-Reviews-JR_Tower_Hotel_Nikko_Sapporo-Sapporo_Hokkaido.html"
}
```

Example 4

```json
{
  "ホテル名": "京王プラザホテル札幌",
  "ランキング": "13位：札幌市のホテル175軒中",
  "入力URL": "https://www.tripadvisor.jp/Hotels-g298143-Hokkaido-Hotels.html",
  "取得日時": "2026-09-09 04:38:45",
  "口コミ数": "1268",
  "料金": "￥25,777",
  "星評価": "4.1",
  "設備_サービス": "レストラン・飲食店 バー・ラウンジ フィットネスセンター エアコン",
  "詳細ページURL": "https://www.tripadvisor.jp/Hotel_Review-g298560-d505346-Reviews-Keio_Plaza_Hotel_Sapporo-Sapporo_Hokkaido.html"
}
```

Example 5

```json
{
  "ホテル名": "ヴィラフォンテーヌ グランド 羽田空港",
  "取得日時": "2026-08-10 10:50:54",
  "口コミ数": "267",
  "料金": "￥14,842",
  "星評価": "4",
  "設備_サービス": "エステ・マッサージ レストラン・飲食店 バー・ラウンジ フィットネスセンター",
  "詳細ページURL": "https://www.tripadvisor.jp//Hotel_Review-g1066454-d20063612-Reviews-Hotel_Villa_Fontaine_Grand_Haneda_Airport-Ota_Tokyo_Tokyo_Prefecture_Kanto.html"
}
```

## 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-jp-hotel-listings-scraper",
  "taskName": "Tripadvisor Hotel Listings Scraper（for Japan）",
  "parameters": "{\"check-in_time\":\"2027-01-25\",\"check_out_time\":\"2027-02-06\",\"number_of_pages\":28,\"uRL\":[\"https://www.tripadvisor.jp/Hotels-g298236-Tokushima_Tokushima_Prefecture_Shikoku-Hotels.html\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"check-in_time\":\"2027-01-25\",\"check_out_time\":\"2027-02-06\",\"number_of_pages\":28,\"uRL\":[\"https://www.tripadvisor.jp/Hotels-g298236-Tokushima_Tokushima_Prefecture_Shikoku-Hotels.html\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "tripadvisor-jp-hotel-listings-scraper",
        "taskName": "Tripadvisor Hotel Listings Scraper（for Japan）",
        "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-jp-hotel-listings-scraper",
  "taskName": "Tripadvisor Hotel Listings Scraper（for Japan）",
  "parameters": "{\"check-in_time\":\"2027-01-25\",\"check_out_time\":\"2027-02-06\",\"number_of_pages\":28,\"uRL\":[\"https://www.tripadvisor.jp/Hotels-g298236-Tokushima_Tokushima_Prefecture_Shikoku-Hotels.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-jp-hotel-listings-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/tripadvisor-jp-hotel-listings-scraper.json)
- [Manifest](https://www.octoparse.com/templates/tripadvisor-jp-hotel-listings-scraper-manifest.json)