Hot Pepper Gourmet Scraper

Extract comprehensive restaurant data from Japan's Hot Pepper Gourmet platform via the official Recruit API. Get restaurant names, addresses, genres, budgets, ratings, photos, and detailed operational information with reliable API-based scraping.

Features

• Official API Integration: Uses Hot Pepper Gourmet Search API for reliable data extraction
• Flexible Search: Filter by keyword, area, and genre code
• Comprehensive Data: Extract 40+ data points including names, addresses, photos, opening hours, facilities
• Pagination Support: Automatically handles pagination to fetch up to 1,000+ results
• Structured Output: Clean JSON format with normalized field names
• Rate Limited: Built-in request delays (300ms) to respect API rate limits
• Error Handling: Robust error handling with detailed logging
• Timestamp Tracking: Records scrape time for data freshness tracking

Use Cases

• Restaurant Marketing: Build a local restaurant database for marketing campaigns
• Market Research: Analyze restaurant distribution, genres, and budget segments in Japan
• Business Intelligence: Monitor competitor restaurants by area and cuisine type
• Travel Planning: Extract restaurant recommendations for specific regions and cuisines
• Data Integration: Sync Hot Pepper restaurant data to your CRM, spreadsheets, or database

Input

{
  "keyword": "イタリアン",
  "area": "Z011",
  "genre": "G001",
  "apiKey": "your-api-key-here",
  "maxResults": 500
}

Input Parameters

Parameter	Type	Required	Default	Description
apiKey	string	Yes	-	Your Hot Pepper Gourmet API key from https://webservice.recruit.co.jp/. Keep this secret.
keyword	string	No	-	Search keyword (e.g., restaurant name, cuisine type like "イタリアン" for Italian).
area	string	No	-	Area code for geographic filtering (e.g., "Z011" for Tokyo). See Hot Pepper API documentation for complete area codes.
genre	string	No	-	Genre code for cuisine filtering (e.g., "G001" for Japanese, "G002" for Western). See Hot Pepper API documentation for genre codes.
maxResults	integer	No	100	Maximum number of restaurants to fetch (1-1000). Higher values mean longer execution time and higher costs.

Area Code Examples

• Z011 - Tokyo
• Z012 - Yokohama
• Z013 - Kawasaki
• Z021 - Osaka
• Z022 - Kobe
• See API docs for complete list of 47 prefecture codes

Genre Code Examples

• G001 - Japanese cuisine
• G002 - Western cuisine
• G003 - Italian
• G004 - French
• G006 - Chinese
• G007 - Korean
• G008 - Asian
• See API docs for complete list of 20+ genre codes

Output

{
  "id": "J000123456",
  "name": "Restaurant Name",
  "nameKana": "レストランメイ",
  "address": "東京都渋谷区道玄坂1-2-3",
  "stationName": "渋谷駅",
  "latitude": 35.6595,
  "longitude": 139.7004,
  "genre": "イタリアン",
  "genreCode": "G003",
  "genreCatch": "Italian restaurant in Tokyo",
  "subGenre": null,
  "budget": "¥3,000～¥3,999",
  "budgetAverage": "¥3,500",
  "budgetMemo": "Average per person",
  "catchPhrase": "Authentic Italian in Shibuya",
  "capacity": 60,
  "access": "5 minutes walk from Shibuya Station",
  "url": "https://www.hotpepper.jp/strJ000123456/",
  "photoUrlLarge": "https://...",
  "photoUrlMedium": "https://...",
  "openingHours": "11:00～23:00",
  "closingDays": "Mondays",
  "partyCapacity": 20,
  "wifi": "yes",
  "creditCard": "yes",
  "privateRoom": "yes",
  "lunch": "available",
  "midnight": "available",
  "english": "available",
  "pet": "yes",
  "child": "yes",
  "parking": "yes",
  "barrierFree": "yes",
  "nonSmoking": "yes",
  "scrapedAt": "2024-02-12T10:30:45.123Z"
}

Output Fields

Field	Type	Description
id	string	Unique restaurant ID in Hot Pepper system
name	string	Restaurant name in Japanese
nameKana	string	Restaurant name in Katakana
address	string	Full address including prefecture, city, and street
stationName	string	Nearest train station
latitude	number	Geographic latitude coordinate
longitude	number	Geographic longitude coordinate
genre	string	Primary cuisine genre (e.g., "イタリアン")
genreCode	string	Genre code used for filtering
budget	string	Typical budget range (e.g., "¥3,000～¥3,999")
budgetAverage	string	Average cost per person
catchPhrase	string	Restaurant's marketing catch phrase
capacity	number	Total seating capacity
url	string	Direct link to Hot Pepper restaurant page
photoUrlLarge	string	Large restaurant photo URL (480x360px)
photoUrlMedium	string	Medium restaurant photo URL (300x225px)
openingHours	string	Opening hours (e.g., "11:00～23:00")
closingDays	string	Days the restaurant is closed
partyCapacity	number	Maximum party size accommodated
wifi	string	WiFi availability ("yes" / "no")
creditCard	string	Credit card acceptance ("yes" / "no")
privateRoom	string	Private room availability ("yes" / "no")
lunch	string	Lunch availability ("available" / unavailable)
midnight	string	Late-night service ("available" / unavailable)
english	string	English language support ("yes" / "no")
pet	string	Pet-friendly ("yes" / "no")
child	string	Child-friendly ("yes" / "no")
parking	string	Parking available ("yes" / "no")
barrierFree	string	Wheelchair accessible ("yes" / "no")
nonSmoking	string	Non-smoking areas ("yes" / "no")
scrapedAt	string	ISO 8601 timestamp of data collection

Pricing

$3 per 1,000 restaurants

Cost Examples

Restaurants	Cost
100	$0.30
500	$1.50
1,000	$3.00
5,000	$15.00
10,000	$30.00

Note: Pricing is based on actual data fetched. Empty results (no matching restaurants) do not incur charges.

Tips

1. Get a Free API Key: Register at https://webservice.recruit.co.jp/ to obtain a Hot Pepper API key. Free tier allows up to 50,000 API calls/month.

2. Start with Keywords: If you're new to Hot Pepper, search by keyword (e.g., "ラーメン" for ramen) before filtering by area or genre codes.

3. Use Area Codes for Geographic Targeting: Combine area codes with keywords to narrow results to specific regions (Tokyo, Osaka, etc.).

4. Paginate Large Datasets: Set maxResults to 1000 per run and run multiple actors with different area codes to avoid timeout issues.

5. Cache Results Locally: Store exported restaurant data in your database to avoid re-scraping the same data repeatedly.

6. Monitor API Quota: Hot Pepper Free API has rate limits. The actor includes 300ms delays between requests to stay within limits.

7. Export to Popular Formats: The Apify platform supports exporting results as JSON, CSV, Excel, or direct database integration.

8. Verify Open Hours: The openingHours field may contain special notation (e.g., "11:00～23:00 (金・土は～0:00)"). Parse carefully for conditional hours.

9. Photo URLs Expire: Hot Pepper photo URLs may expire after 30 days. Download and store images locally if archiving data long-term.

10. API Response Time: Budget approximately 2-5 minutes for 1,000 restaurant results depending on API latency.

Integrations

Export scraped restaurant data to your favorite platforms:

• Google Sheets: Automatically push results to Google Sheets via Zapier/Make
• Excel/CSV: Download results in Excel format with formatted columns
• Webhooks: Send data to your API endpoint for real-time processing
• Database: Sync directly to PostgreSQL, MongoDB, MySQL via Apify integrations
• Zapier/Make: Create workflows to send restaurant data to CRM, email, Slack
• Google Maps: Import latitude/longitude for location visualization
• Data Studio: Create dashboards and visualizations from Hot Pepper data

Support

For issues, feature requests, or API troubleshooting:

• Hot Pepper API Help: Official Documentation
• Apify Support: Apify Support Center
• Report Issues: Open an issue on GitHub or contact support through Apify

License

Apache-2.0 License

---

Data Source: Hot Pepper Gourmet (ホットペッパーグルメ) - Official API by Recruit Co., Ltd.

Last Updated: 2024-02-12