Japan Hotel Rates and Date Watchlist

Collect dated room and plan stay prices from Jalan and Rakuten for a hotel watchlist. Compare properties and dates, inspect cheaper room categories, and repeat the same input to track rate changes. Refund deadlines and payment preferences are optional conditions in the separate verified same-room comparison.

Main use: property and date rate shopping

Supply targets containing 1–10 {provider, hotelId} objects and stays containing 1–7 {checkIn, checkOut} pairs. A run accepts at most 20 target/stay combinations. Each provider/property/stay produces one dataset row with exact source room/plan IDs, original room labels, advertised stay amounts, meal facts when disclosed, source-order positions, a dated source link, occupancy, acquisition time, and a stable observationKey.

{
  "targets": [
    {"provider": "jalan", "hotelId": "344614"},
    {"provider": "rakuten", "hotelId": "147116"},
    {"provider": "jalan", "hotelId": "372448"},
    {"provider": "rakuten", "hotelId": "388"}
  ],
  "stays": [
    {"checkIn": "2026-11-10", "checkOut": "2026-11-11"},
    {"checkIn": "2026-11-17", "checkOut": "2026-11-18"}
  ],
  "adults": 2,
  "maxOffersPerProvider": 50
}

Find Jalan's six-digit property ID in its /yadNNNNNN/ URL and Rakuten's numeric ID in /hotelinfo/plan/ID. IDs are provider-specific; the Actor never converts them or assumes two supplied IDs describe the same property. The dated source must echo the exact hotel ID, stay dates, adults, one room and no children. Live examples verified on 2026-10-03 include Royal Park Tokyo Haneda (Jalan 344614 / Rakuten 147116), Ryokan Nakanaka (Jalan 372448), and Hotel Metropolitan Tokyo (Rakuten 388), each with 1, 2 and 4 adults. Other valid property IDs use the same guarded listing contract and may fail explicitly if their source layout is unsupported, unavailable or exceeds the response bound.

adults accepts 1–4, default 2; one room and no children. Each stay is 1–7 nights; check-in is a future date within 365 days in Asia/Tokyo. maxOffersPerProvider is 1–50, default 50. Return entries in original source order. loadedOfferCount describes the inspected page before the output bound; scopeTruncated identifies further pages or omitted room/plan entries. No pagination or detail request is needed for ordinary price observations.

cheapestObservedAdvertisedStayJpy is the minimum among returned advertised room/plan stay amounts. Different room categories and meal packages remain separate observations. It is not a same-room provider comparison, a whole-hotel/global minimum, or a total including undisclosed mandatory fees. consumptionTaxIncluded is affirmative only when disclosed for the joined price. Service inclusion, extra required fees, final payable total, cancellation deadline and payment options remain null when this listing does not establish them. An unavailable Rakuten room must have zero source amounts and matching explicit no-vacancy evidence; zero is never a free rate. Missing structures or prices cannot establish a negative. No whole-hotel sold-out claim is inferred.

Repeat a watchlist on an Apify schedule and compare observationKey, room/plan IDs and observedAt between datasets to monitor changes. The Actor produces current snapshots; it does not persist a price history or send notifications itself.

Optional verified same-room total comparison

Legacy input remains available as a separate mode: supply hotel, checkIn, and checkOut, without targets/stays. Only the corroborated Royal Park Tokyo Haneda standard-floor Superior Twin, one room/two adults/room only, is supported for strict cross-provider matching. No fuzzy room matching is used.

{"hotel":"royal-park-tokyo-haneda","checkIn":"2026-11-10","checkOut":"2026-11-11"}

freeCancellationBy optionally requires both compared offers to advertise free cancellation through that date. requireLocalPayment optionally requires an affirmative pay-at-hotel option; default false. Ordinary supported-room totals are not withheld solely because pay-at-hotel is unavailable or unknown. When that filter is true, denials, unknowns, conditional statements and contradictions suppress ranking while retaining all payment evidence. The cancellation cutoff is today or later and no later than check-in.

Strict mode retains original room/area/bed evidence, meal fields, stay windows, cancellation tiers, payment facts, consumption-tax/service inclusion, local-tax evidence and missing reasons. Rank only supported 15:00–11:00 room-only offers with complete mandatory-fee evidence and any requested optional conditions. Preserve Jalan 25 m² / Rakuten 24.5 m² / official 24.8 m² evidence. Unknown fees or missing nightly lodging bases prevent all-in ranking. Exclude other rooms/floors, meals, day use, transit rooms, children/extra beds and reduced stay windows. Stays are 1–7 nights with checkout no later than 2027-04-01; longer-date watchlist observations do not use this older Tokyo tax rule. Strict detail limit is 1–8 per provider, default 8. Divergent unkeyed Rakuten cancellation policies fail strict acquisition; ordinary watchlist prices never join those arrays.

Charging and limits

The hotel-compared event is $0.02 per delivered screen. In watchlist mode, one screen means one provider/property/stay, up to 20 events/run ($0.40). In curated comparison mode, one screen contains both completed provider acquisitions and uses one event. No per-offer event or double manual charge. Event budget must cover every requested screen before network work. All requested acquisitions and validation complete before any delivery; an upstream failure produces no rows or events. An explicitly evidenced no-price screen can be useful negative information within its stated source scope.

HTTP only, 256 MB, no proxy, browser or paid API. Maximum 22 GETs including robots, 20 seconds/request and 120 seconds overall; no retries. Watchlist listings are limited to 4 MiB decoded response bytes and 500 source room/plan entries per page. Curated comparison keeps the 2,000,000-byte response cap. Robots policies, crawl delays and request rates are respected before each host/redirect; same-host starts are spaced at least 0.2 seconds or the larger robots interval. Redirects remain on the fixed allowed source routes. Date/occupancy/property echoes, plan/room membership and DOM/numeric amount joins are mandatory. Challenges, access failures, rate limits, timeouts, malformed data and changed structures fail explicitly.

Prices and policies can change before reservation; no booking is performed.

Privacy and source terms

Output public property/room/date/price facts and short policy evidence only. No reviews, images, contacts, guests, personal booking data, cookies, tokens or raw HTML. Use generated dated listing URLs, excluding tracking or reservation endpoints. Provider terms and exact source excerpts are recorded in the dated scouts under DR-0007; robots/access/PII guards remain mandatory.