{ "openapi": "3.0.1", "info": { "title": "Jalan.net Reviews Scraper (じゃらん クチコミ)", "description": "Scrape Jalan (じゃらん クチコミ) hotel reviews, all or only new ones. Just add hotel URLs, hotel ID numbers or Japanese names and get overall and six category scores, title, full text, posting date, stay month, reviewer age, gender and purpose, plan, room, meal and hotel reply. $2.50 per 1,000 reviews.", "version": "1.0", "x-build-id": "KFtyBL0eCNfpoqYwh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/boncross~jalan-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-boncross-jalan-reviews", "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/boncross~jalan-reviews/runs": { "post": { "operationId": "runs-sync-boncross-jalan-reviews", "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/boncross~jalan-reviews/run-sync": { "post": { "operationId": "run-sync-boncross-jalan-reviews", "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": { "hotels": { "title": "Hotels", "type": "array", "description": "jalan.net hotel URLs, hotel ID numbers, or Japanese hotel names.", "default": [ "https://www.jalan.net/yad301552/" ], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (bulk upload)", "type": "array", "description": "Jalan page addresses, with the option to load them in bulk from a file, a Google Sheet or a remote list. Use this when you have more links than you want to paste. Combined with anything in the list above.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviewsPerHotel": { "title": "Max reviews per hotel", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Jalan serves 30 per page.", "default": 90 }, "maxItems": { "title": "Maximum results for the whole run", "minimum": 0, "type": "integer", "description": "A run-wide ceiling across every target. The per-target limit above applies to each one separately, so ten targets at 50 each returns 500; set this to cap the total. Zero means no run-wide limit. Rows that report an input the actor could not resolve are not counted here and are never charged for.", "default": 0 }, "sort": { "title": "Sort", "enum": [ "newest", "rating_high", "room", "bath", "breakfast", "dinner", "service", "cleanliness" ], "type": "string", "description": "Newest first, or highest score first by overall or by one category.", "default": "newest" }, "minRating": { "title": "Min rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep reviews with overall score ≥ this (1–5). Post-filter, free. Scores are decimal, so 4.5 is a valid bound.", "default": 0 }, "maxRating": { "title": "Max rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep reviews with overall score ≤ this (1–5). 0 = no limit. Scores are decimal, so 4.5 is a valid bound.", "default": 0 }, "travelPurposes": { "title": "Travel purposes", "type": "array", "description": "Keep only these reviewer purposes: `solo`, `couple`, `family`, `friends`, `business`, `group`, or a Japanese label fragment (一人旅, 夫婦旅行, 家族旅行, 友達旅行, 出張).", "default": [], "items": { "type": "string" } }, "postedAfter": { "title": "Posted after", "type": "string", "description": "YYYY-MM-DD. Drop reviews posted before this date (use with `newest`).", "default": "" }, "includeOlderReviews": { "title": "Include reviews older than a year", "type": "boolean", "description": "Jalan's main review list covers the last 12 months. With this on, once that list runs out (and the per-hotel limit still has room), the run carries on into the hotel's older reviews, back to the oldest Jalan still shows — often several years and many times more reviews. Older reviews always come newest first, after the recent ones, whatever sort you choose. Each row says which list it came from in `isArchived`.", "default": true }, "includeHotelSummary": { "title": "Include hotel summary on each row", "type": "boolean", "description": "Repeat the hotel's overall rating, review count and six category averages on every review.", "default": true }, "summaryOnly": { "title": "Summary only", "type": "boolean", "description": "One row per hotel with the aggregate scores, no individual reviews (charged as `hotel-summary`).", "default": false }, "dedupStoreName": { "title": "Dedup store name", "type": "string", "description": "Named key-value store remembering reviews already returned, so scheduled runs push only new ones.", "default": "" }, "delayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 15000, "type": "integer", "description": "Optional pause before each call, in milliseconds. 0 (the default) runs as fast as the parallel limit allows.", "default": 0 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 32, "type": "integer", "description": "How many requests run at once across the whole run. The default is the fastest level measured clean; lower it only if a run reports refusals or errors.", "default": 16 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }