# Jalan Hotel Listings Scraper

Template for extracting hotel and accommodation information (hotel name, star rating, price, etc.) from Jalan via URL.

- Template page: [https://www.octoparse.com/template/jalan-hotel-listings-scraper](https://www.octoparse.com/template/jalan-hotel-listings-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 listing pages.

## Output

The current workflow extracts 17 fields, including `アクセス`, `タブ1`, `タブ2`, `タブ3`, `ホテル名`, `宿泊プラン1`, `宿泊プラン2`, `宿泊プラン3`, `当前页URL`, `料金1`, `料金2`, `料金3`, `星評価`, `最安料金_税込`, `紹介`, `評価件数`, `詳細ページ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 URLs and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URLs

Required. MainKeys Constraints: minItems=1; maxItems=100; items.minLength=1; items.maxLength=100000.

## How to Use

# Jalan Hotel Listings Scraper

Collects hotel and accommodation listing data from [Jalan](https://www.jalan.net/) by URL: name, star rating, review count, description, access, cheapest tax-included rate, and up to 3 stay plans with tags and prices.

## Output Fields

The template returns these fields:

- `URL`
- `ホテル名`
- `詳細ページURL`
- `星評価`
- `評価件数`
- `紹介`
- `アクセス`
- `最安料金_税込`
- `宿泊プラン1`, `タグ1`, `料金1`
- `宿泊プラン2`, `タグ2`, `料金2`
- `宿泊プラン3`, `タグ3`, `料金3`

Fields such as `宿泊プラン3`, `タグ3`, and `料金3` can be empty when the source record does not provide them. The template collects only data that Jalan displays on listing pages.

## Input

- `URL (up to 100 per run)` — required. Enter one or more URLs, one per line.

## Pricing

- No per-line charge for this template.
- Octoparse plan or resource limits may still apply.

## How to Run

1. Open the template and select **Try it** or **Start**.
2. Enter up to 100 listing URLs, one per line.
3. Choose a **local** or **cloud** run.
4. Review the returned rows.
5. Export to CSV, Excel, JSON, databases, or cloud storage, or send the data to reporting/AI workflows through Octoparse APIs.

You can schedule recurring runs and reuse exported data through 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. For local scheduled runs, keep your computer and Octoparse open.

## Limitations

- Collects listing or search-result fields only, not full detail-page data. Use a detail-page template when deeper record data is required.
- Some plan/tag/price fields may be empty if the source record does not provide them.

## Tips

- Start with one or a few URLs and review the rows before scaling.
- Use the most specific valid URL to reduce unrelated or duplicate records.
- Use a stable field such as `URL`, `ホテル名`, or `詳細ページURL` 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

- [Tripadvisor Hotel Listings Scraper（for Japan）](https://www.octoparse.com/template/tripadvisor-jp-hotel-listings-scraper)
- [Booking.com Hotel Listing Scraper](https://www.octoparse.com/template/booking-com-scraper)
- [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)
- [Airbnb.fr Hotel Info Scraper](https://www.octoparse.com/template/airbnb-fr-hotel-info-scraper)

## Input Schema

```json
{
  "title": "Jalan Hotel Listings Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRLs": {
      "title": "URLs",
      "description": "MainKeys",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100000
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "uRLs": [
    "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0,0,0,0,0&rootCd=041"
  ]
}
```

Example 2

```json
{
  "uRLs": [
    "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0,0,0,0,0&rootCd=041"
  ]
}
```

Example 3

```json
{
  "uRLs": [
    "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0,0,0,0,0&rootCd=041"
  ]
}
```

Example 4

```json
{
  "uRLs": [
    "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0,0,0,0,0&rootCd=041"
  ]
}
```

Example 5

```json
{
  "uRLs": [
    "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0,0,0,0,0&rootCd=041"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "アクセス": {
      "type": "string",
      "description": ""
    },
    "タブ1": {
      "type": "string",
      "description": ""
    },
    "タブ2": {
      "type": "string",
      "description": ""
    },
    "タブ3": {
      "type": "string",
      "description": ""
    },
    "ホテル名": {
      "type": "string",
      "description": ""
    },
    "宿泊プラン1": {
      "type": "string",
      "description": ""
    },
    "宿泊プラン2": {
      "type": "string",
      "description": ""
    },
    "宿泊プラン3": {
      "type": "string",
      "description": ""
    },
    "当前页URL": {
      "type": "string",
      "description": ""
    },
    "料金1": {
      "type": "string",
      "description": ""
    },
    "料金2": {
      "type": "string",
      "description": ""
    },
    "料金3": {
      "type": "string",
      "description": ""
    },
    "星評価": {
      "type": "string",
      "description": ""
    },
    "最安料金_税込": {
      "type": "string",
      "description": ""
    },
    "紹介": {
      "type": "string",
      "description": ""
    },
    "評価件数": {
      "type": "string",
      "description": ""
    },
    "詳細ページURL": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Jalan Hotel Listings 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

Example 1

```json
{
  "アクセス": "JR札幌駅（16番出口）徒歩7分、地下鉄さっぽろ駅（16番出口）徒歩7分",
  "タブ1": "ダブル 朝のみ",
  "タブ2": "ダブル 食事なし",
  "タブ3": "ツイン 朝のみ",
  "ホテル名": "札幌ホテル by グランベル（２０２５年３月１日オープン）",
  "宿泊プラン1": "【スタンダード／温泉スパ付】札幌駅徒歩7分◆北海道のごちそうが並ぶ70種の朝食ビュッフェ＜朝食付＞",
  "宿泊プラン2": "【スタンダード／温泉スパ付】札幌駅より徒歩7分◆スパ＆サウナで寛ぐ札幌ステイ＜素泊まり＞",
  "宿泊プラン3": "【じゃらんスペシャルウィーク】20％OFF！温泉スパ&サウナ◆北海道のごちそうが並ぶ70種の朝食ビュッフェ",
  "当前页URL": "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0%2C0%2C0%2C0%2C0&rootCd=041",
  "料金1": "28,200 円～",
  "料金2": "21,200 円～",
  "料金3": "23,520 円～",
  "星評価": "4.1",
  "最安料金_税込": "16,960円～",
  "紹介": "JR札幌駅北口から徒歩7分。全室24㎡以上のゆとりある客室は、デザイン性溢れる空間。ご宿泊者無料の高層階温泉スパは、半露天風呂・サウナ完備。地上約100mのレストラン＆BARから夜景を望む贅沢なご滞在を。",
  "評価件数": "288件",
  "詳細ページURL": "https://www.jalan.net/yad344941/?stayCount=1&roomCount=1&dateUndecided=1&adultNum=2&distCd=01&childPriceFlg=0,0,0,0,0&roomCrack=200000&stayYear=&stayMonth=&stayDay=&rootCd=041&screenId=UWW1402&yadNo=344941&callbackHistFlg=1"
}
```

Example 2

```json
{
  "アクセス": "JR札幌駅（16番出口）徒歩7分、地下鉄さっぽろ駅（16番出口）徒歩7分",
  "タブ1": "ダブル 朝のみ",
  "タブ2": "ツイン 食事なし",
  "タブ3": "ツイン 朝のみ",
  "ホテル名": "札幌ホテル by グランベル（２０２５年３月１日オープン）",
  "宿泊プラン1": "【スタンダード／温泉スパ付】札幌駅徒歩7分◆北海道のごちそうが並ぶ70種の朝食ビュッフェ＜朝食付＞",
  "宿泊プラン2": "【スタンダード／温泉スパ付】札幌駅より徒歩7分◆スパ＆サウナで寛ぐ札幌ステイ＜素泊まり＞",
  "宿泊プラン3": "【早期割90／温泉スパ付】早めのご予約でお得◆北海道のごちそうが並ぶ70種の朝食ビュッフェ＜朝食付＞",
  "当前页URL": "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0%2C0%2C0%2C0%2C0&rootCd=041",
  "料金1": "28,200 円～",
  "料金2": "22,400 円～",
  "料金3": "26,010 円～",
  "星評価": "4.2",
  "最安料金_税込": "16,960円～",
  "紹介": "JR札幌駅北口から徒歩7分。全室24㎡以上のゆとりある客室は、デザイン性溢れる空間。ご宿泊者無料の高層階温泉スパは、半露天風呂・サウナ完備。地上約100mのレストラン＆BARから夜景を望む贅沢なご滞在を。",
  "評価件数": "283件",
  "詳細ページURL": "https://www.jalan.net/yad344941/?stayCount=1&roomCount=1&childPriceFlg=0,0,0,0,0&roomCrack=200000&adultNum=2&stayDay=&stayYear=&stayMonth=&dateUndecided=1&rootCd=041&distCd=01&screenId=UWW1402&yadNo=344941&callbackHistFlg=1"
}
```

Example 3

```json
{
  "アクセス": "札幌駅北口から徒歩３分！JRや地下鉄からでもアクセスしやすく好立地！近くにはコンビニもあり利便性も◎",
  "タブ1": "ダブル 朝のみ",
  "タブ2": "ダブル 食事なし",
  "タブ3": "ツイン 食事なし",
  "ホテル名": "京王プレリアホテル札幌",
  "宿泊プラン1": "【宿泊満足度部門別85点以上】高層階コンフォートタイプ（バス・トイレ別）へ無料グレードUP！☆朝食付☆",
  "宿泊プラン2": "【ふたり旅におすすめ】高層階コンフォートタイプ（バス・トイレ別）へ無料グレードUP！☆素泊り☆",
  "宿泊プラン3": "【連泊割★素泊り】～２連泊以上の滞在がお得！連泊でのご旅行をお考えの方におすすめ～【じゃらん限定】",
  "当前页URL": "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0%2C0%2C0%2C0%2C0&rootCd=041",
  "料金1": "20,100 円～",
  "料金2": "14,500 円～",
  "料金3": "13,500 円～",
  "星評価": "4.5",
  "最安料金_税込": "13,500円～",
  "紹介": "じゃらん OF THE YEAR 泊まってよかった宿大賞（接客・サービス）北海道301室以上 第3位！札幌駅北口から徒歩３分◎大浴場、ラウンジなどの館内設備も充実。朝食は旬の北海道産食材の魅力を五感で楽しめる",
  "評価件数": "1,177件",
  "詳細ページURL": "https://www.jalan.net/yad377605/?childPriceFlg=0,0,0,0,0&roomCrack=200000&rootCd=041&stayYear=&stayMonth=&stayDay=&stayCount=1&roomCount=1&dateUndecided=1&adultNum=2&distCd=01&screenId=UWW1402&yadNo=377605&callbackHistFlg=1"
}
```

Example 4

```json
{
  "アクセス": "札幌駅北口から徒歩３分！JRや地下鉄からでもアクセスしやすく好立地！近くにはコンビニもあり利便性も◎",
  "タブ1": "ダブル 朝のみ",
  "タブ2": "ダブル 食事なし",
  "タブ3": "ツイン 朝のみ",
  "ホテル名": "京王プレリアホテル札幌",
  "宿泊プラン1": "【宿泊満足度部門別85点以上】高層階コンフォートタイプ（バス・トイレ別）へ無料グレードUP！☆朝食付☆",
  "宿泊プラン2": "【ふたり旅におすすめ】高層階コンフォートタイプ（バス・トイレ別）へ無料グレードUP！☆素泊り☆",
  "宿泊プラン3": "【じゃらんスペシャルウィーク】2泊以上でさらにおトクな連泊割！★朝食付★",
  "当前页URL": "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0%2C0%2C0%2C0%2C0&rootCd=041",
  "料金1": "20,100 円～",
  "料金2": "14,500 円～",
  "料金3": "17,560 円～",
  "星評価": "4.5",
  "最安料金_税込": "12,400円～",
  "紹介": "じゃらん OF THE YEAR 泊まってよかった宿大賞（接客・サービス）北海道301室以上 第3位！札幌駅北口から徒歩３分◎大浴場、ラウンジなどの館内設備も充実。朝食は旬の北海道産食材の魅力を五感で楽しめる",
  "評価件数": "1,173件",
  "詳細ページURL": "https://www.jalan.net/yad377605/?stayYear=&stayMonth=&stayDay=&stayCount=1&roomCount=1&dateUndecided=1&adultNum=2&distCd=01&childPriceFlg=0,0,0,0,0&roomCrack=200000&rootCd=041&screenId=UWW1402&yadNo=377605&callbackHistFlg=1"
}
```

Example 5

```json
{
  "アクセス": "札幌駅北口から徒歩３分！JRや地下鉄からでもアクセスしやすく好立地！近くにはコンビニもあり利便性も◎",
  "タブ1": "ダブル 朝のみ",
  "タブ2": "ツイン 食事なし",
  "タブ3": "ダブル 食事なし",
  "ホテル名": "京王プレリアホテル札幌",
  "宿泊プラン1": "【宿泊満足度部門別85点以上】高層階コンフォートタイプ（バス・トイレ別）へ無料グレードUP！☆朝食付☆",
  "宿泊プラン2": "【連泊割★素泊り】～２連泊以上の滞在がお得！連泊でのご旅行をお考えの方におすすめ～【じゃらん限定】",
  "宿泊プラン3": "【ふたり旅におすすめ】高層階コンフォートタイプ（バス・トイレ別）へ無料グレードUP！☆素泊り☆",
  "当前页URL": "https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0%2C0%2C0%2C0%2C0&rootCd=041",
  "料金1": "20,100 円～",
  "料金2": "13,500 円～",
  "料金3": "14,500 円～",
  "星評価": "4.5",
  "最安料金_税込": "12,400円～",
  "紹介": "じゃらん OF THE YEAR 泊まってよかった宿大賞（接客・サービス）北海道301室以上 第3位！札幌駅北口から徒歩３分◎大浴場、ラウンジなどの館内設備も充実。朝食は旬の北海道産食材の魅力を五感で楽しめる",
  "評価件数": "1,167件",
  "詳細ページURL": "https://www.jalan.net/yad377605/?stayCount=1&roomCount=1&dateUndecided=1&adultNum=2&distCd=01&rootCd=041&childPriceFlg=0,0,0,0,0&roomCrack=200000&stayYear=&stayMonth=&stayDay=&screenId=UWW1402&yadNo=377605&callbackHistFlg=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": "jalan-hotel-listings-scraper",
  "taskName": "Jalan Hotel Listings Scraper",
  "parameters": "{\"uRLs\":[\"https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0,0,0,0,0&rootCd=041\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"uRLs\":[\"https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0,0,0,0,0&rootCd=041\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "jalan-hotel-listings-scraper",
        "taskName": "Jalan Hotel Listings Scraper",
        "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": "jalan-hotel-listings-scraper",
  "taskName": "Jalan Hotel Listings Scraper",
  "parameters": "{\"uRLs\":[\"https://www.jalan.net/010000/LRG_010200/?roomCount=1&adultNum=2&distCd=01&child5Num=&mealType=&photo=1&child4Num=&roomCrack=200000&dateUndecided=1&child3Num=&afCd=&child1Num=&child2Num=&childPriceFlg=0,0,0,0,0&rootCd=041\"]}"
}
JSON
```

## MCP Setup

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