# Rakuten Price Monitor: 楽天価格モニター (Ichiba) (`getascraper/rakuten-jp-price-monitor`) Actor Scheduled price and stock monitoring for Rakuten Ichiba, Japan. Diff mode emits only products whose price or stock status changed since the last run — back-in-stock and price-drop alerts for 楽天 価格 モニター. - **URL**: https://apify.com/getascraper/rakuten-jp-price-monitor.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.99 / 1,000 price changes This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 💴 Rakuten Price Monitor: 楽天価格モニター (Ichiba)
Know the moment a Rakuten Ichiba price drops or an item comes back in stock.
This Actor watches products on 楽天市場, Japan's largest online mall, and hands back only what changed since your last check. Japanese or English keywords, scheduled runs, one clean 楽天 価格 モニター feed of price drops, restocks, and rating changes.
📉 Changed only
No re-reading the same unchanged rows every run 		📦 Stock + price history
Old price, new price, restocks, and the exact delta 		🇯🇵 JP + EN search
Search however you already think about products 		⭐ Rating + points
Review score and reward points on every item
Checking Rakuten prices by hand means opening the same listings over and over, hoping you catch the drop before the deal is gone. This Actor watches for you. Give it search keywords in Japanese or English, run it on a schedule, and get a clean feed of price drops, restocks, and rating changes, nothing more. Works out of the box, no account or setup required. ### 🔍 What does Rakuten Price Monitor do? Give it search keywords to watch, in Japanese or English. On each scheduled run, it checks the current search results and compares them to what it saw last time. By default it hands back only the items whose price or stock status actually changed, so you are never re-reading the same unchanged rows. It tracks price, in stock or out of stock status, review score, and reward points for every item. ### 💡 Why use it? "I resell imported goods sourced from Japan. I watch a list of keywords every morning so I can reprice the moment a supplier drops a cost." "I hunt deals on Rakuten for hobby items. I keep a wishlist of search terms and this tells me the day a price actually falls, instead of me checking by hand." "I do import and arbitrage work between Japan and other markets. I need to know Japanese prices before a competitor does, so a daily changed-only feed is exactly what I track margins with." "I run a shop on Rakuten myself. I watch my own shop's name as a search term so I notice instantly if a listing goes out of stock or a price gets changed by mistake." ### 🚀 How to use it
STEP 1
Add your keywords
In Japanese or English, or paste a search link. 		STEP 2
Schedule it
Keep "only changed" on and set a daily run. 		STEP 3
Get only the changes
To Sheets, Slack, a dashboard, or a download.
### ⚙️ Input At least one search keyword or start URL is required. | Field | Type | Required | Description | |---|---|---|---| | `searchTerms` | array of strings | No | Search keywords to monitor, in Japanese or English. | | `startUrls` | array of strings | No | Rakuten search page links to monitor directly. | | `onlyChanged` | boolean | No | Return only items whose price or stock changed since the last run. Default on. | | `maxPagesPerQuery` | integer | No | Search result pages to check per keyword (50 items each). | | `maxItems` | integer | No | Hard cap on total rows returned across all queries. 0 means unlimited. | ### 📦 Output Each row is one product, with change details included whenever something moved since the last run. Download results as JSON, CSV, or Excel. ```json { "query": "任天堂スイッチ", "queryType": "keyword", "itemCode": "rakutenmobile-store:10001910", "itemName": "楽天モバイル iPhone 17e", "itemPrice": 109200, "availability": 1, "inStock": true, "shopName": "楽天モバイル公式 楽天市場店", "shopUrlCode": "rakutenmobile-store", "itemUrl": "https://item.rakuten.co.jp/rakutenmobile-store/iphone-17e/", "imageUrl": "https://thumbnail.image.rakuten.co.jp/example.jpg", "reviewScore": 4.5, "reviewCount": 128, "pointCount": 992, "genreId": "/0/564500/560202", "changeType": "PRICE_DROP", "oldPrice": 118800, "priceDelta": -9600, "priceDeltaPct": -8.08, "isChanged": true, "scrapedAt": "2026-07-06T02:14:09.004Z" } ```` ### 📊 Data table | Field | Type | Description | |---|---|---| | `query` | string | The keyword or start URL that produced this row. | | `queryType` | string | Whether this came from a keyword or a direct URL. | | `itemCode` | string | Unique identifier for this product on Rakuten. | | `itemName` | string | Product name as listed on Rakuten. | | `itemPrice` | number | Current price in yen. | | `availability` | number | Raw stock flag, 1 for in stock and 0 for out of stock. | | `inStock` | boolean | Whether the item is currently in stock. | | `shopName` | string | Name of the Rakuten shop selling this item. | | `shopUrlCode` | string | Rakuten's code for the selling shop. | | `itemUrl` | string | Link to the product page. | | `imageUrl` | string | Link to the product's main image. | | `reviewScore` | number | Average review score out of 5. | | `reviewCount` | number | Number of customer reviews. | | `pointCount` | number | Reward points offered on this item. | | `genreId` | string | Rakuten category ID for the product. | | `changeType` | string | What changed: new, price drop, price rise, back in stock, out of stock, or unchanged. | | `oldPrice` | number | Price recorded on the previous run, when different. | | `priceDelta` | number | Change in price in yen since the last run. | | `priceDeltaPct` | number | Change in price as a percentage since the last run. | | `isChanged` | boolean | Whether this row changed since the last run. | | `scrapedAt` | string | Timestamp of this check. | ### 💰 Pricing Pricing is pay per result. You only pay for the rows returned, so a run that finds no changes costs nothing. There are no monthly subscriptions and no minimum spend. ### ⭐ Enjoying Rakuten Price Monitor?
⭐ ⭐ ⭐ ⭐ ⭐
If this Actor caught a price drop or a restock for you, leave a quick review.
A 5-star rating takes 10 seconds and helps other resellers, importers, and deal hunters find it. Your feedback also tells us what to build next.
★  Rate this Actor on Apify
### ✨ Tips - On your first run, turn "only changed" off once to capture a full baseline snapshot of every item. - Watching a shop's own name as a keyword is a good way to catch a competitor's repricing or restocking before anyone else notices. - Pair a daily schedule with Google Sheets to build a running price history without touching a spreadsheet by hand. ### ❓ FAQ ##### 楽天の価格変動を監視するには？ Add your Rakuten search keywords to the input, keep "only changed" turned on, and set a schedule. Each run returns only the items whose price or stock moved since the last check. ##### Do I need a Rakuten account or an Application ID? No. This Actor works directly against Rakuten's public search results. There is no account, sign-up, or ID to obtain. ##### How fresh is the data? Data reflects the moment each scheduled run executes. Set the schedule to hourly, daily, or weekly depending on how quickly you need to know about changes. ##### Can I track more than one keyword at once? Yes. Add as many search keywords or start URLs as you like; each is checked and diffed independently. ##### Is this legal? This Actor reads the same public search results any visitor to Rakuten Ichiba would see in a browser. You are responsible for following Rakuten's terms of use for your own use of the results. # Actor input Schema ## `searchTerms` (type: `array`): Japanese or English search keywords to monitor on Rakuten Ichiba ## `startUrls` (type: `array`): Rakuten search URLs (search.rakuten.co.jp/search/mall/...) to monitor directly ## `onlyChanged` (type: `boolean`): When enabled, only products whose price or availability changed since the last run are returned. Disable to get a full snapshot every run. ## `maxPagesPerQuery` (type: `integer`): Search result pages to fetch per query (50 items per page). ## `maxItems` (type: `integer`): Hard cap on total rows returned across all queries. 0 = unlimited. ## `proxyConfiguration` (type: `object`): Datacenter proxy (the default) is fast and cost-efficient and works reliably here. Switch to Residential only if a very large run starts hitting rate limits. ## Actor input object example ```json { "onlyChanged": true, "maxPagesPerQuery": 3, "maxItems": 0, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `keyValueStore` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "onlyChanged": true, "maxPagesPerQuery": 3, "maxItems": 0, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/rakuten-jp-price-monitor").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "onlyChanged": True, "maxPagesPerQuery": 3, "maxItems": 0, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/rakuten-jp-price-monitor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "onlyChanged": true, "maxPagesPerQuery": 3, "maxItems": 0, "proxyConfiguration": { "useApifyProxy": true } }' | apify call getascraper/rakuten-jp-price-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/rakuten-jp-price-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Rakuten Price Monitor: 楽天価格モニター (Ichiba)", "description": "Scheduled price and stock monitoring for Rakuten Ichiba, Japan. Diff mode emits only products whose price or stock status changed since the last run — back-in-stock and price-drop alerts for 楽天 価格 モニター.", "version": "0.2", "x-build-id": "ya2hr4CDBQlwq7PZy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~rakuten-jp-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-rakuten-jp-price-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/getascraper~rakuten-jp-price-monitor/runs": { "post": { "operationId": "runs-sync-getascraper-rakuten-jp-price-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/getascraper~rakuten-jp-price-monitor/run-sync": { "post": { "operationId": "run-sync-getascraper-rakuten-jp-price-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Search keywords", "type": "array", "description": "Japanese or English search keywords to monitor on Rakuten Ichiba", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Rakuten search URLs (search.rakuten.co.jp/search/mall/...) to monitor directly", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "onlyChanged": { "title": "Only emit changed products", "type": "boolean", "description": "When enabled, only products whose price or availability changed since the last run are returned. Disable to get a full snapshot every run.", "default": true }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 1, "maximum": 20, "type": "integer", "description": "Search result pages to fetch per query (50 items per page).", "default": 3 }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Hard cap on total rows returned across all queries. 0 = unlimited.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Datacenter proxy (the default) is fast and cost-efficient and works reliably here. Switch to Residential only if a very large run starts hitting rate limits.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```