Rakuten Travel Scraper

Apify Actor to scrape Japan hotel data from Rakuten Travel using the official Rakuten Travel API. Search hotels by keyword, retrieve hotel rankings, and collect detailed hotel information across all regions of Japan.

Features

• Keyword Hotel Search: Search for hotels by keyword (e.g., "Tokyo", "Osaka", "Kyoto") using the Rakuten Travel KeywordHotelSearch API
• Hotel Rankings: Retrieve Rakuten Travel's hotel popularity rankings by genre (overall, onsen, etc.)
• Automatic Pagination: Fetches multiple pages of results up to your specified limit
• Rate Limiting: Built-in 1 request/second rate limiting to comply with Rakuten API guidelines
• Retry Logic: Automatic retry with exponential backoff on transient errors

Use Cases

• Collect Japan hotel data for market research and price analysis
• Monitor hotel availability and pricing trends across Japanese cities
• Build hotel comparison datasets for travel planning tools
• Aggregate Rakuten Travel hotel reviews and ratings

Input Parameters

Parameter	Type	Required	Default	Description
application_id	string	Yes	-	Rakuten API Application ID
access_key	string	Yes	-	Rakuten API Access Key
mode	string	No	search	search for keyword search, ranking for hotel rankings
keyword	string	No	-	Search keyword (e.g., "Tokyo", "Osaka")
genre	string	No	all	Ranking genre (e.g., "all", "onsen")
max_results	integer	No	30	Maximum results (1-1000)
log_level	string	No	INFO	Logging level (DEBUG/INFO/WARNING/ERROR)

Output

Each hotel record contains:

• hotel_name - Hotel name
• hotel_id - Rakuten hotel number
• hotel_special - Hotel description/highlights
• hotel_min_charge - Minimum room price (JPY)
• latitude / longitude - Geographic coordinates
• postal_code - Postal code
• address - Full address
• telephone - Phone number
• access - Transportation access information
• parking - Parking information
• nearest_station - Nearest train station
• hotel_image_url / hotel_thumbnail_url - Hotel images
• review_count - Number of reviews
• review_average - Average review score
• hotel_url - Rakuten Travel hotel page URL
• plan_list_url - Rakuten Travel plan list URL
• area_name - Area/region name (ranking mode)

Getting API Credentials

1. Register at Rakuten Web Service
2. Create an application to get your Application ID and Access Key
3. Both credentials are free to obtain

Example Input

Search Mode

{
    "application_id": "YOUR_APP_ID",
    "access_key": "YOUR_ACCESS_KEY",
    "mode": "search",
    "keyword": "Tokyo",
    "max_results": 50
}

Ranking Mode

{
    "application_id": "YOUR_APP_ID",
    "access_key": "YOUR_ACCESS_KEY",
    "mode": "ranking",
    "genre": "all",
    "max_results": 10
}

Technical Details

• Uses the new openapi.rakuten.co.jp API domain (migrated Feb 2026)
• Built with Python 3.12, aiohttp, Pydantic v2
• Structured JSON logging via structlog
• Fully typed with comprehensive test coverage