# Booking.com Reviews Scraper (for Japan)

Template for extracting reviews (ratings, rating scores and submission dates) from Booking via URLs.

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

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

## Output

The current workflow extracts 14 fields, including `ID`, `WiFi_無料_`, `お得感`, `クチコミ_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 Enter URL Listing(up to 1000 per run) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Enter URL Listing(up to 1000 per run)

Required. https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\_adults=2&req\_adults=2&no\_rooms=1&group\_children=0&req\_children=0&hpos=1&hapos=1&sr\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&from=searchresults#hotelTmpl Constraints: minItems=1; maxItems=1000; items.minLength=1; items.maxLength=1000.

## How to Use

# Booking.com Reviews Scraper (for Japan)

## Purpose

Collects review data from [Booking.com](https://www.booking.com/) using URLs: ratings, rating scores, and submission dates.

Does not analyze data. Analysis must be done after export or in a downstream reporting/AI workflow.

## Pricing

Currently no per-line charge.

Octoparse plan or resource limits may still apply.

## Input

- `Enter URL Listing(up to 1000 per run)` (required): one or more Booking.com review URLs, one per line.

## Output Fields

The template returns these fields:

- `店名`
- `クチコミ_URL`
- `スタッフ`
- `施設_設備`
- `清潔さ`
- `快適さ`
- `お得感`
- `ロケーション`
- `WiFi_無料_`
- `ID`
- `国名`
- `投稿日`
- `評価`
- `評価点数`

## How to Use

1. Open the template and select **Try it** or **Start**.
2. Enter URLs in `Enter URL Listing(up to 1000 per run)`.
3. Choose a local or cloud run.
4. Review the returned rows, then export or process the structured data.

## Limitations

- Collects only the fields listed above from Booking.com review pages.
- Does not add data that Booking.com does not display.
- Fields such as `投稿日`, `評価`, and `評価点数` may be empty when the source record does not provide them.

## Tips

- Start with one or a few inputs before scaling.
- Use the most specific valid `Enter URL Listing(up to 1000 per run)` to reduce unrelated or duplicate records.
- When available, use stable identifiers from fields such as `ID` or `クチコミ_URL` as the deduplication key.

## Scheduling, Export, and API

- Run the template locally or in the cloud.
- Export rows to CSV, Excel, JSON, databases, or cloud storage.
- Send data to reporting or AI workflows through Octoparse APIs.
- Recurring runs and API access, including the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates), may require a paid Octoparse plan.
- For local scheduled runs, keep your computer and Octoparse open.

## 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.com Listing Scraper (for Spain)](https://www.octoparse.com/template/booking-hotel-listados-scraper)
- [Booking.com Hotel Details Scraper (for Germany)](https://www.octoparse.com/template/booking-hotel-details-scraper-for-germany)
- [Booking.com Hotel List Scraper (for Italy)](https://www.octoparse.com/template/crawler-lista-hotel-booking)
- [Google Scholar Article Scraper (for Japan)](https://www.octoparse.com/template/google-scholar-jp-article-scraper)
- [At Home Japan For-Sale Property Scraper](https://www.octoparse.com/template/at-home-japan-for-sale-property-scraper)

## Input Schema

```json
{
  "title": "Booking.com Reviews Scraper (for Japan) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "enter_URL_Listing": {
      "title": "Enter URL Listing(up to 1000 per run)",
      "description": "https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\\_adults=2&req\\_adults=2&no\\_rooms=1&group\\_children=0&req\\_children=0&hpos=1&hapos=1&sr\\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&from=searchresults#hotelTmpl",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1000
      },
      "minItems": 1,
      "maxItems": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "enter_URL_Listing"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "enter_URL_Listing": [
    "https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\\_adults=2&req\\_adults=2&no\\_rooms=1&group\\_children=0&req\\_children=0&hpos=1&hapos=1&sr\\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&from=searchresults#hotelTmpl"
  ]
}
```

Example 2

```json
{
  "enter_URL_Listing": [
    "https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\\_adults=2&req\\_adults=2&no\\_rooms=1&group\\_children=0&req\\_children=0&hpos=1&hapos=1&sr\\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&from=searchresults#hotelTmpl"
  ]
}
```

Example 3

```json
{
  "enter_URL_Listing": [
    "https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\\_adults=2&req\\_adults=2&no\\_rooms=1&group\\_children=0&req\\_children=0&hpos=1&hapos=1&sr\\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&from=searchresults#hotelTmpl"
  ]
}
```

Example 4

```json
{
  "enter_URL_Listing": [
    "https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\\_adults=2&req\\_adults=2&no\\_rooms=1&group\\_children=0&req\\_children=0&hpos=1&hapos=1&sr\\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&from=searchresults#hotelTmpl"
  ]
}
```

Example 5

```json
{
  "enter_URL_Listing": [
    "https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\\_adults=2&req\\_adults=2&no\\_rooms=1&group\\_children=0&req\\_children=0&hpos=1&hapos=1&sr\\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&from=searchresults#hotelTmpl"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "ID": {
      "type": "string",
      "description": ""
    },
    "WiFi_無料_": {
      "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": ""
    },
    "投稿日": {
      "type": "string",
      "description": ""
    },
    "施設_設備": {
      "type": "string",
      "description": ""
    },
    "清潔さ": {
      "type": "string",
      "description": ""
    },
    "評価": {
      "type": "string",
      "description": ""
    },
    "評価点数": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Booking.com Reviews 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
{
  "ID": "Michelle",
  "WiFi_無料_": "9.0",
  "お得感": "8.1",
  "クチコミ_URL": "https://www.booking.com/hotel/jp/shinjuku-prince.html?aid=304142&label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ddc441581ec5cbcd78ce063c1a837d23&dist=0&hapos=1&hpos=1&sb_price_type=total&srepoch=1663059951&srpvid=dbf43ff7e5560114&type=total&ucfs=1&#tab-reviews",
  "スタッフ": "9.2",
  "ロケーション": "9.5",
  "国名": " United States",
  "店名": "",
  "快適さ": "8.9",
  "投稿日": "Reviewed: November 6, 2024",
  "施設_設備": "8.5",
  "清潔さ": "8.7",
  "評価": "Enjoyed breakfast and dinner very much\nGreat location…..shopping, eating, transportation \nEveryone was polite, efficient…..just excellent workers\nWe got the room near the elevator and lower floor as we have requested(made our stay easy to get around)",
  "評価点数": "Scored 9.0\n9.0"
}
```

Example 2

```json
{
  "ID": "James",
  "WiFi_無料_": "8.9",
  "お得感": "8.0",
  "クチコミ_URL": "https://www.booking.com/hotel/jp/shinjuku-prince.html?aid=304142&label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=9282c1f524423cc6f8c71b4d504aa17f&dist=0&hapos=1&hpos=1&keep_landing=1&sb_price_type=total&srepoch=1663059951&srpvid=dbf43ff7e5560114&type=total&ucfs=1&chal_t=1789486146721&force_referer=#tab-reviews",
  "スタッフ": "9.2",
  "ロケーション": "9.5",
  "国名": " Australia",
  "店名": "",
  "快適さ": "8.9",
  "投稿日": "Reviewed: September 15, 2026",
  "施設_設備": "8.5",
  "清潔さ": "8.7",
  "評価": "Location",
  "評価点数": "Scored 7.0\n7.0"
}
```

Example 3

```json
{
  "ID": "Ornella",
  "WiFi_無料_": "8.9",
  "お得感": "8.0",
  "クチコミ_URL": "https://www.booking.com/hotel/jp/shinjuku-prince.html?aid=304142&label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=4621827a72cd1180e7019d985ec267e8&dist=0&hapos=1&hpos=1&keep_landing=1&sb_price_type=total&srepoch=1663059951&srpvid=dbf43ff7e5560114&type=total&ucfs=1&chal_t=1787668729200&force_referer=#tab-reviews",
  "スタッフ": "9.1",
  "ロケーション": "9.5",
  "国名": " Australia",
  "店名": "",
  "快適さ": "8.8",
  "投稿日": "Reviewed: August 21, 2026",
  "施設_設備": "8.4",
  "清潔さ": "8.7",
  "評価": "Central location, modern, soundproof",
  "評価点数": "Scored 9.0\n9.0"
}
```

Example 4

```json
{
  "ID": "Dichao",
  "WiFi_無料_": "8.9",
  "お得感": "8.0",
  "クチコミ_URL": "https://www.booking.com/hotel/jp/shinjuku-prince.html?aid=304142&label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=55645106b1c3cb2be0dbb696331bbeb7&dist=0&hapos=1&hpos=1&keep_landing=1&sb_price_type=total&srepoch=1663059951&srpvid=dbf43ff7e5560114&type=total&ucfs=1&chal_t=1787060313652&force_referer=#tab-reviews",
  "スタッフ": "9.1",
  "ロケーション": "9.5",
  "国名": "Active since 2017",
  "店名": "",
  "快適さ": "8.8",
  "投稿日": "Reviewed: August 17, 2026",
  "施設_設備": "8.4",
  "清潔さ": "8.7",
  "評価": "location is great",
  "評価点数": "Scored 9.0\n9.0"
}
```

Example 5

```json
{
  "ID": "Mahendra",
  "WiFi_無料_": "8.9",
  "お得感": "8.0",
  "クチコミ_URL": "https://www.booking.com/hotel/jp/shinjuku-prince.html?aid=304142&label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=2eb08368a47896083249d526a542cfa2&dist=0&hapos=1&hpos=1&keep_landing=1&sb_price_type=total&srepoch=1663059951&srpvid=dbf43ff7e5560114&type=total&ucfs=1&chal_t=1786372616466&force_referer=#tab-reviews",
  "スタッフ": "9.1",
  "ロケーション": "9.4",
  "国名": "4 reviews",
  "店名": "",
  "快適さ": "8.8",
  "投稿日": "Reviewed: August 7, 2026",
  "施設_設備": "8.4",
  "清潔さ": "8.7",
  "評価": "Central location",
  "評価点数": "Scored 8.0\n8.0"
}
```

## 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-jp-reviews-scraper",
  "taskName": "Booking.com Reviews Scraper (for Japan)",
  "parameters": "{\"enter_URL_Listing\":[\"https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\\\\_adults=2&req\\\\_adults=2&no\\\\_rooms=1&group\\\\_children=0&req\\\\_children=0&hpos=1&hapos=1&sr\\\\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&from=searchresults#hotelTmpl\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"enter_URL_Listing\":[\"https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\\\\_adults=2&req\\\\_adults=2&no\\\\_rooms=1&group\\\\_children=0&req\\\\_children=0&hpos=1&hapos=1&sr\\\\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&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-jp-reviews-scraper",
        "taskName": "Booking.com Reviews 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": "booking-jp-reviews-scraper",
  "taskName": "Booking.com Reviews Scraper (for Japan)",
  "parameters": "{\"enter_URL_Listing\":[\"https://www.booking.com/hotel/jp/shinjuku-prince.ja.html?label=gen173nr-1FCAEoggI46AdIFVgEaIkCiAEBmAEVuAEZyAEM2AEB6AEB-AECiAIBqAIDuALjj4GZBsACAdICJDQ5MTkxMWEzLTY0ZmQtNDI5My05MmQzLTdkMjJmNjcxMmQzZdgCBeACAQ&sid=ca1c1dd14cdbb0d6e301ab35566c73fe&aid=304142&ucfs=1&arphpl=1&group\\\\_adults=2&req\\\\_adults=2&no\\\\_rooms=1&group\\\\_children=0&req\\\\_children=0&hpos=1&hapos=1&sr\\\\_order=popularity&srpvid=dbf43ff7e5560114&srepoch=1663059951&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-jp-reviews-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-jp-reviews-scraper.json)
- [Manifest](https://www.octoparse.com/templates/booking-jp-reviews-scraper-manifest.json)