# Jalan Scraper ? Japan Hotels, Ryokans & Reviews (`huggable_quote/jalan-scraper`) Actor Extract hotel, ryokan, and onsen data from Jalan.net ? Japan's largest domestic travel platform. 20x cheaper than alternatives. - **URL**: https://apify.com/huggable\_quote/jalan-scraper.md - **Developed by:** [OrbitData Labs](https://apify.com/huggable_quote) (community) - **Categories:** Lead generation, Travel, Other - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Jalan Scraper ? Japan Hotels, Ryokans & Reviews Extract hotel, ryokan, and onsen data from [Jalan.net](https://www.jalan.net/) ? Japan's largest domestic travel platform by Recruit Holdings. ### Why this scraper? - **Ryokan & onsen specialist**: Extracts onsen type, private bath availability, bath ratings ? data unique to Japanese traditional inns - **6 category ratings**: Service, room, bath, meal (breakfast & dinner), cleanliness ? not just an overall score - **Reviews with travel context**: Stay date, travel companion type (solo/couple/family/business), room type, plan name - **25+ fields per property, 15+ fields per review** ? the most comprehensive Jalan data extraction available - **Affordable at $3.50 per 1,000 results** ? cost-effective for large-scale data collection - From the maker of [Tabelog Scraper](https://apify.com/huggable_quote/tabelog-scraper) (Japan's #1 restaurant data on Apify) ### Perfect for Japan Travel Research Japan saw 36M+ inbound tourists in 2024 ? an all-time record. If you're building travel apps, doing hospitality research, or analyzing the Japanese accommodation market, this is the most affordable way to get Jalan data. ### What data can you extract? #### Property Details (25+ fields) - Name, type (hotel/ryokan), address, prefecture, area - Overall rating + 6 category ratings (service, room, bath, breakfast, dinner, cleanliness) - Amenities, photos (up to 20) - **Onsen data**: hot spring name & type, private bath, outdoor bath - Room types with counts and sizes - Parking info, access info - Check-in/out times #### Reviews (15+ fields per review) - Review text and title, 6 rating categories - Stay date, room type, meal type, price range - Travel companion (solo, couple, family, friends, business) - Plan name (which package they booked) - Post date ### Input options #### Direct property URLs Provide Jalan.net property page URLs directly: ```` https://www.jalan.net/yad357796/ https://www.jalan.net/yad321344/ ``` #### Search by area (dropdown) Select prefectures from the **Search by Area** dropdown ? all 47 prefectures are available: `tokyo`, `kyoto`, `osaka`, `hokkaido`, `okinawa`, `kanagawa`, `nagano`, ... #### Search / Area listing URLs Provide area listing URLs to discover properties: ``` https://www.jalan.net/130000/LRG\_136200/ (Tokyo Station area) https://www.jalan.net/140000/LRG\_141600/ (Hakone) ```` #### Configuration | Field | Default | Description | |-------|---------|-------------| | `searchAreas` | ? | Select prefectures to search (dropdown) | | `maxResultsPerSearch` | 30 | Max properties per search URL | | `includeReviews` | true | Scrape reviews for each property | | `maxReviewsPerProperty` | 20 | Max reviews per property (0 = all) | | `language` | ja | Content language (ja/en) | ### Pricing - **$3.50 per 1,000 results** (Pay per event) ### Output examples #### Hotel output ```json { "propertyId": "357796", "propertyName": "?z?e??JAL?V?e?B?H?c ????", "propertyUrl": "https://www.jalan.net/yad357796/", "propertyType": "hotel", "prefecture": "?????s", "area": "???c?E??X?E?H?c????", "address": "?H?c?????S?|?P?P", "postalCode": "144-0042", "overallRating": 4.4, "roomRating": 4.4, "bathRating": 4.0, "breakfastRating": 4.3, "serviceRating": 4.4, "cleanlinessRating": 4.4, "reviewCount": 3500, "hasOnsen": false, "currency": "JPY", "amenities": ["?n???h?^?I??", "?{?f?B?\?[?v", "?h???C???[", "???????g?C??", "..."], "photos": ["https://cdn.jalan.jp/jalan/images/pict2L/Y6/Y357796/Y357796830.jpg"], "roomTypes": [ {"name": "?V???O??", "count": 200, "size": "15?`16m2"}, {"name": "?_?u??", "count": 59, "size": "16?`17m2"}, {"name": "?c?C??", "count": 49, "size": "18?`31m2"} ], "checkInTime": "15:00", "checkOutTime": "11:00", "reviews": [ { "reviewTitle": "?H?c??`???p????????????", "reviewText": "?H?c??`?s????????????}?o?X????????????????v???????...", "overallRating": 5.0, "roomRating": 5.0, "bathRating": 4.0, "breakfastRating": 5.0, "serviceRating": 4.0, "cleanlinessRating": 5.0, "reviewerGender": "????", "reviewerAge": "20??", "travelCompanion": "family", "travelCompanionRaw": "??????s", "stayDate": "2026?N5???h??", "planName": "?ySAVER?z?V???v????X?e?C?I?^???H?r???b?t?F?t", "roomType": "?_?u??", "mealType": "?????", "priceRange": "14,001?`15,000?~(??l?P????????/???)", "reviewDate": "2026/5/8" } ], "scrapedAt": "2026-05-14T07:30:00+00:00", "language": "ja" } ```` #### Ryokan with onsen output (killer feature) ```json { "propertyId": "321344", "propertyName": "?g?r????", "propertyUrl": "https://www.jalan.net/yad321344/", "propertyType": "ryokan", "prefecture": "?_???", "area": "????", "address": "???{?T?X?V", "postalCode": "250-0311", "overallRating": 4.5, "roomRating": 4.2, "bathRating": 4.6, "breakfastRating": 4.5, "dinnerRating": 4.5, "serviceRating": 4.3, "cleanlinessRating": 4.3, "reviewCount": 1167, "hasOnsen": true, "onsenName": "???????{????", "onsenType": "????|??????", "hasOutdoorBath": true, "hasPrivateBath": true, "currency": "JPY", "amenities": ["?n???h?^?I??", "?{?f?B?\?[?v", "?h???C???[", "????", "..."], "roomTypes": [ {"name": "?c?C??", "count": 12, "size": "40?`40m2"} ], "checkInTime": "14:00", "checkOutTime": "10:00", "reviews": [ { "reviewTitle": "????I??A?b?v?f?[?g?????a??????", "reviewText": "???w??2?l???????R??????????A???????????h??...", "overallRating": 5.0, "roomRating": 5.0, "bathRating": 5.0, "breakfastRating": 5.0, "dinnerRating": 5.0, "serviceRating": 5.0, "cleanlinessRating": 5.0, "reviewerGender": "?j??", "reviewerAge": "40??", "travelCompanion": "family_with_children", "travelCompanionRaw": "?q?A???s", "stayDate": "2026?N5???h??", "planName": "?y????30?z?g?r???{?????v?????@???20???I?t?I2?????T?t??", "roomType": "?a??", "mealType": "???E?[", "priceRange": "30,001?~???(??l?P????????/???)", "reviewDate": "2026/5/7" } ], "scrapedAt": "2026-05-14T07:30:00+00:00", "language": "ja" } ``` ### Use cases - **Japan inbound tourism market research** ? analyze accommodation trends - **Hotel/ryokan price monitoring** ? competitive intelligence for hospitality - **Review sentiment analysis** ? understand guest satisfaction by category - **Travel app development** ? build recommendation engines with rich data - **Academic research** ? study the Japanese hospitality industry - **Tour operator planning** ? data-driven destination selection ### Japan Travel Data Suite by huggable\_quote Build the complete Japan travel dataset: - [Tabelog Scraper](https://apify.com/huggable_quote/tabelog-scraper) ? Japan's #1 restaurant review platform - **Jalan Scraper** (this actor) ? Hotels, ryokans & onsen accommodations ### Technical notes - Built with Python, httpx (async HTTP), and BeautifulSoup4 - Polite crawling with random delays (1?3s between requests) - Automatic retry with exponential backoff - Apify Proxy support (Japan proxies recommended) - Handles Shift\_JIS/Windows-31J encoding (Jalan's native charset) - Handles both hotel and ryokan page layouts # Actor input Schema ## `startUrls` (type: `array`): Direct Jalan.net property page URLs. Example: https://www.jalan.net/yad357796/ ## `searchUrls` (type: `array`): Jalan.net search or area listing URLs. Example: https://www.jalan.net/130000/LRG\_136200/ ## `searchAreas` (type: `array`): Select prefectures/areas to search for hotels and ryokans. ## `maxResultsPerSearch` (type: `integer`): Maximum number of properties to collect per search/area URL. ## `includeReviews` (type: `boolean`): Whether to scrape reviews for each property. ## `maxReviewsPerProperty` (type: `integer`): Maximum number of reviews to collect per property. Set 0 for all reviews. ## `language` (type: `string`): Content language. 'ja' for Japanese (more data), 'en' for English. ## `proxyConfiguration` (type: `object`): Proxy settings. Japan proxies recommended for best results. ## Actor input object example ```json { "maxResultsPerSearch": 30, "includeReviews": true, "maxReviewsPerProperty": 20, "language": "ja" } ``` # Actor output Schema ## `properties` (type: `string`): Dataset containing property details (25+ fields) and reviews (15+ fields per review) from Jalan.net. Includes ratings, onsen info, amenities, room types, and travel context. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("huggable_quote/jalan-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("huggable_quote/jalan-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call huggable_quote/jalan-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=huggable_quote/jalan-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jalan Scraper ? Japan Hotels, Ryokans & Reviews", "description": "Extract hotel, ryokan, and onsen data from Jalan.net ? Japan's largest domestic travel platform. 20x cheaper than alternatives.", "version": "1.0", "x-build-id": "kWgmwa6DyidW5DYeO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/huggable_quote~jalan-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-huggable_quote-jalan-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/huggable_quote~jalan-scraper/runs": { "post": { "operationId": "runs-sync-huggable_quote-jalan-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/huggable_quote~jalan-scraper/run-sync": { "post": { "operationId": "run-sync-huggable_quote-jalan-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Hotel/Ryokan URLs", "type": "array", "description": "Direct Jalan.net property page URLs. Example: https://www.jalan.net/yad357796/", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchUrls": { "title": "Search / Area URLs", "type": "array", "description": "Jalan.net search or area listing URLs. Example: https://www.jalan.net/130000/LRG_136200/", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchAreas": { "title": "Search by Area", "type": "array", "description": "Select prefectures/areas to search for hotels and ryokans.", "items": { "type": "string", "enum": [ "hokkaido", "aomori", "iwate", "miyagi", "akita", "yamagata", "fukushima", "ibaraki", "tochigi", "gunma", "saitama", "chiba", "tokyo", "kanagawa", "niigata", "toyama", "ishikawa", "fukui", "yamanashi", "nagano", "gifu", "shizuoka", "aichi", "mie", "shiga", "kyoto", "osaka", "hyogo", "nara", "wakayama", "tottori", "shimane", "okayama", "hiroshima", "yamaguchi", "tokushima", "kagawa", "ehime", "kochi", "fukuoka", "saga", "nagasaki", "kumamoto", "oita", "miyazaki", "kagoshima", "okinawa" ], "enumTitles": [ "Hokkaido", "Aomori", "Iwate", "Miyagi", "Akita", "Yamagata", "Fukushima", "Ibaraki", "Tochigi", "Gunma", "Saitama", "Chiba", "Tokyo", "Kanagawa", "Niigata", "Toyama", "Ishikawa", "Fukui", "Yamanashi", "Nagano", "Gifu", "Shizuoka", "Aichi", "Mie", "Shiga", "Kyoto", "Osaka", "Hyogo", "Nara", "Wakayama", "Tottori", "Shimane", "Okayama", "Hiroshima", "Yamaguchi", "Tokushima", "Kagawa", "Ehime", "Kochi", "Fukuoka", "Saga", "Nagasaki", "Kumamoto", "Oita", "Miyazaki", "Kagoshima", "Okinawa" ] } }, "maxResultsPerSearch": { "title": "Max results per search URL", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of properties to collect per search/area URL.", "default": 30 }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Whether to scrape reviews for each property.", "default": true }, "maxReviewsPerProperty": { "title": "Max reviews per property", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to collect per property. Set 0 for all reviews.", "default": 20 }, "language": { "title": "Language", "enum": [ "ja", "en" ], "type": "string", "description": "Content language. 'ja' for Japanese (more data), 'en' for English.", "default": "ja" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Japan proxies recommended for best results." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```