Rakuten Product Scraper - Japan E-Commerce Data

Scrape product data from Rakuten Ichiba, Japan's largest online marketplace, using the official Rakuten Web Service API. Get prices, reviews, images, and 40+ data fields per product.

What It Does

This Actor searches Rakuten Ichiba products through the official API and returns structured product data. It supports keyword search, category (genre) filtering, shop-specific queries, price range filtering, and multiple sort options.

Data source: Rakuten Web Service API (official, free)

Use Cases

• E-commerce research - Analyze product listings, pricing, and availability across Japan's largest marketplace
• Price monitoring - Track price changes for specific products or categories over time
• Competitor analysis - Monitor competitor shops, their product range, and pricing strategies
• Market research - Discover trending products, popular categories, and consumer review patterns
• Affiliate marketing - Find high-rated products with affiliate links for content monetization

Getting Started

You need a free Rakuten API Application ID and Access Key:

1. Register at Rakuten Web Service
2. Create an application to get your Application ID and Access Key
3. Use those as the application_id and access_key input parameters

Note: Since the Feb 2026 Rakuten API migration, both application_id and access_key are required. The new API endpoint is https://openapi.rakuten.co.jp/ichibams/api/IchibaItem/Search/20220601.

Input Parameters

Parameter	Type	Required	Default	Description
application_id	string	Yes	-	Rakuten API Application ID
access_key	string	Yes	-	Rakuten API Access Key
keyword	string	No	-	Search keyword (e.g., "iPhone", "ノートパソコン")
genre_id	string	No	-	Rakuten genre ID for category filtering
shop_code	string	No	-	Filter by specific Rakuten shop
sort	string	No	standard	Sort: -reviewCount, +itemPrice, -itemPrice, standard, -reviewAverage, -updateTimestamp
min_price	integer	No	-	Minimum price filter (JPY)
max_price	integer	No	-	Maximum price filter (JPY)
availability	boolean	No	true	Only available items
has_review	boolean	No	false	Only items with reviews
postage_flag	boolean	No	false	Only free shipping items
max_results	integer	No	100	Maximum results (1-3000)
log_level	string	No	INFO	Logging verbosity: DEBUG, INFO, WARNING, ERROR

Output Example

Each product in the dataset contains 40+ fields:

{
    "item_name": "Apple iPhone 15 128GB SIMフリー",
    "item_price": 112800,
    "item_url": "https://item.rakuten.co.jp/apple-store/iphone15-128/",
    "item_code": "apple-store:iphone15-128",
    "shop_name": "Apple公式 楽天市場店",
    "shop_code": "apple-store",
    "shop_url": "https://www.rakuten.co.jp/apple-store/",
    "catchcopy": "最新iPhone 送料無料",
    "item_caption": "Apple iPhone 15 128GB。A16 Bionicチップ搭載...",
    "image_urls": [
        "https://thumbnail.image.rakuten.co.jp/@0_mall/apple-store/cabinet/iphone15.jpg"
    ],
    "review_count": 256,
    "review_average": 4.7,
    "genre_id": "564500",
    "availability": true,
    "tax_flag": true,
    "postage_flag": true,
    "credit_card_flag": true,
    "gift_flag": false,
    "ship_overseas_flag": false,
    "point_rate": 1.0,
    "point_rate_start_time": null,
    "point_rate_end_time": null,
    "start_time": null,
    "end_time": null,
    "item_price_min1": null,
    "item_price_max1": null,
    "affiliate_url": null
}

Limits

• Rate limit: ~1 request/second (handled automatically with built-in throttling)
• Max results per query: 3,000 items (30 items/page x 100 pages)
• API key: Free, requires registration at Rakuten Web Service

Technical Details

• Uses the official Rakuten IchibaItem/Search API (v20220601) via openapi.rakuten.co.jp
• Automatic pagination with configurable result limits
• Exponential backoff retry on rate limiting (HTTP 429)
• Structured JSON logging via structlog
• Pydantic v2 data validation