Rakuten Ichiba Product Scraper 🛍️🇯🇵

Extract product listings from Rakuten Ichiba (楽天市場) — Japan's largest online marketplace — as clean, structured JSON. Search by keyword, genre, price and sort, or drop in direct item URLs, and get prices in JPY, shop info, review scores, Rakuten points, shipping, and (optionally) the full item detail: description, variants/SKUs, stock and availability.

Built on Rakuten's open, anti-bot-free search API — no CAPTCHA fights, no flaky browser automation — so runs are fast and reliable.

---

Who is this for?

You are…	You use it to…
🔁 Reseller / arbitrage	Monitor competitor prices, points & stock across shops; feed repricing tools.
📊 Market researcher / analyst	Map a category or keyword landscape, brand presence and review signals on the JP market.
🛒 E-commerce / SaaS developer	Get a stable, schema-consistent product feed you can schedule and pipe via webhook.
🧠 AI / LLM builder	Feed structured Japanese marketplace data into agents and RAG pipelines.

---

What you get (output fields)

Field	Type	Description
item_id	string	Rakuten item id.
name	string	Product title.
url	string	Canonical item page URL.
price	integer	Current price (JPY).
review_average	number	Average review score (0–5).
review_count	integer	Number of reviews.
points	integer	Rakuten points earned.
shipping_price	integer	Shipping cost (JPY; 0 = free).
free_shipping	boolean	Whether shipping is free.
is_sold_out	boolean	Sold-out flag.
is_used	boolean	Used / second-hand.
shop_id / shop_name / shop_url	–	Seller identity & storefront.
genre_ids / genres	array	Rakuten category path.
image / images	–	Product image URLs.
Detail (optional)		When “Include full detail” is on, or for item URLs:
description_html	string	Full HTML product description.
variants	array	{sku, price, quantity, back_order} per variant.
available / availability_code	–	Live availability.
points_value / tax_rate	number	Points & tax detail.
source	string	Which input produced the row.
scraped_at	string	ISO-8601 scrape timestamp.

Full definitions in the dataset schema tab.

---

High-value use cases

• Price & points monitoring — schedule daily runs on your SKUs/keywords and diff price, points and stock over time.
• Competitive assortment analysis — pull an entire genre to see who sells what, at what price, with what review strength.
• Reselling / sourcing — find under-priced, high-rating, free-shipping items across thousands of Rakuten shops.
• Review-signal research — rank a category by review_average × review_count to find proven best-sellers.
• Catalog enrichment — resolve a list of item URLs to full detail (variants, stock, description) for your own store or dataset.

---

Input parameters

Field	Type	Default	Description
searchQueries	array	[]	Keywords to search (one search each).
itemUrls	array	[]	Direct item URLs or shop/item shorthand.
genreId	integer	–	Restrict searches to a Rakuten genre (category) id.
minPrice / maxPrice	integer	–	Price band in JPY.
sort	enum	standard	standard, priceAsc, priceDesc, newest, popularity.
usedOnly	boolean	false	Only used items.
includeAds	boolean	false	Include sponsored (PR) cards.
includeDetails	boolean	false	Enrich each product with full detail.
maxItems	integer	200	Global result cap.
maxItemsPerQuery	integer	300	Organic rows per keyword.
proxyConfiguration	object	Apify Proxy	Egress proxy.

Example input

{
    "searchQueries": ["マグカップ", "coffee beans"],
    "sort": "popularity",
    "minPrice": 1000,
    "maxPrice": 5000,
    "includeDetails": true,
    "maxItems": 500,
    "maxItemsPerQuery": 250
}

Example output (one row)

{
    "item_id": "10000832",
    "name": "ディーンアンドデルーカ モーニングマグ …",
    "url": "https://item.rakuten.co.jp/deandeluca/dd0050/",
    "price": 1540,
    "currency": "JPY",
    "review_average": 4.63,
    "review_count": 73,
    "points": 14,
    "shipping_price": 460,
    "free_shipping": false,
    "shop_id": 376432,
    "shop_name": "DEAN & DELUCA 公式",
    "genre_ids": ["558944", "566115", "566121", "566157"],
    "num_variants": 4,
    "available": true,
    "source": "search:マグカップ",
    "scraped_at": "2026-08-03T09:12:44Z"
}

---

Scheduling & integrations

• Schedule daily/hourly runs from the Apify Console for continuous price/stock monitoring.
• Webhooks fire on run completion — push new results straight into your app.
• Export to JSON, CSV, Excel, or Google Sheets; stream to S3 or a database via the Apify API/integrations (Make, Zapier).

Use with AI assistants (MCP)

This Actor works as a tool for AI agents through the Apify MCP server, so a Claude/ChatGPT-style assistant can search Rakuten Ichiba and read structured product data on demand. Point your MCP client at Apify and call this Actor by name.

---

FAQ

Is there a result limit? Rakuten returns up to ~6,750 items per keyword. Split by genre or price band, or use many keywords, to go wider.

How fresh is the data? Every run fetches live data at request time.

Do I need a Rakuten account or API key? No. The Actor uses Rakuten's public web search and a built-in guest token for detail — no credentials required.

Does it get blocked? The web search endpoint has no anti-bot gate, so runs are stable. The default Apify Proxy provides a clean, consistent IP.

Japanese text? Output preserves original Japanese (UTF-8). Item names, shops, and descriptions come through exactly as on Rakuten.

Is scraping this legal? You are responsible for how you use the data. This Actor collects only publicly available listing information; review Rakuten's terms and your local regulations before large-scale or commercial use.

Something looks off / a field is missing? Rakuten occasionally changes their payloads. Report an issue on the Actor page and it will be fixed quickly.