HotPepper Gourmet Scraper — Japan Restaurants
Pricing
from $2.00 / 1,000 record scrapeds
HotPepper Gourmet scraper for Japan restaurant data: budgets, address, business phone, hours, seats and private rooms by prefecture and genre — clean English schema. No review text, reviewer data or coupon copy. Unofficial; not affiliated with Recruit Co., Ltd.
REQUIRED. Choose one of the 47 prefectures by its English name (e.g. "Tokyo", "Osaka", "Kyoto"). Via API/CLI pass the English name exactly as listed (e.g. "Tokyo", not "東京都" / "13" / "tokyo-to" — the platform validates the list before the run starts and rejects anything else with the list of valid values). Cities are NOT prefectures: use "Kanagawa" for Yokohama, "Aichi" for Nagoya, "Osaka" for Osaka-shi. HotPepper listings are prefecture-scoped (service areas SA11..SA98); narrow further with genre / area.
Optional. Leave empty to walk ALL 17 genres in site order (each genre = at least one listing request). Choose one HotPepper genre code (the G-code in listing URLs such as https://www.hotpepper.jp/SA11/G001/). API users may also pass the Japanese label (居酒屋, ラーメン …) or an English alias (izakaya, ramen, yakiniku, italian, chinese, bar, cafe, korean, okonomiyaki …) — any other value stops the run immediately with the list of valid genres.
Optional. A Japanese place-name substring (e.g. "新宿", "渋谷", "横浜") matched CLIENT-SIDE against each restaurant's sub-area name, access line, station and address — use the JAPANESE name ("Shibuya" would match nothing because the site text is Japanese). Records that do not match are skipped before any detail request is spent on them. Leave empty for the whole prefecture. Do NOT put a prefecture name here.
Optional, default false. When true, each record costs one extra request and adds the published business info: street address, business phone (from the page's structured data — the phone-reveal endpoint is never called), opening hours, closed days, nearest station, seat count, banquet capacity and facility facts (private rooms, tatami, counter, charter, Wi-Fi, parking, smoking policy, all-you-can-drink/eat, credit cards). When false (default), the actor emits listing data only — 20 records per request with name, genre, sub-area, budgets, access line, phone (when listed) and coordinates.
Optional, default 10. Stop after this many restaurant records (1..1000). Each listing page yields up to 20 records; with detailFetch each record also needs one detail request, so raise maxApiRequests accordingly.
Optional, default 15. Hard budget of HTTP requests to hotpepper.jp for this run (1 per listing page of 20 restaurants + 1 per detail page). Requests are strictly serial with >= 1.2 s spacing. When the budget runs out the run still SUCCEEDS with the records collected so far and complete=false in RUN_SUMMARY (not an error).
