Service
Connect an amazon.co.jp shopper account to search the catalog, read product detail, inspect the cart, saved payment methods, and order history, preview checkout totals, and track products for price drops. Public catalog reads work without a connection; cart, orders, payment methods, and checkout require a signed-in session.
95.04%30-day uptimeAvg response6484ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/amazon-jp/add-cart-item | Add a product_id to the connected shopper's amazon.co.jp cart with an optional quantity (defaults to 1). Use only with explicit user intent to add that item to the cart. Do NOT use to track a product's price without buying it — use amazon-jp:create-price-watch instead. Requires a connected shopper account (signed-in session). Returns action, added, and the updated cart. | |
| POST | /v1/amazon-jp/check-price-drops | Re-fetch every watched product, compare the current price with the saved snapshot and target_price, and update each watch's snapshot. Use on demand or on a schedule to detect price drops for tracked products. Do NOT use to add or remove watches — use amazon-jp:create-price-watch or amazon-jp:delete-price-watch instead. Requires a connected shopper account (signed-in session). Returns action and drops, listing only products whose price fell or reached target_price, each with product_id, title, old_price, new_price, drop_percent, and target_hit. | |
| POST | /v1/amazon-jp/clear-cart | Empty the connected shopper's amazon.co.jp cart. Use only with explicit user intent to remove all cart items. Do NOT use to remove a single item — use amazon-jp:remove-cart-item instead. Requires a connected shopper account (signed-in session). Returns action and the resulting cart. | |
| POST | /v1/amazon-jp/create-price-watch | Create or replace a price watch for a product_id with an optional target_price, storing the current price as the saved snapshot. Use when the user wants to track a product's price over time. Do NOT use to buy the product — use amazon-jp:add-cart-item instead; do NOT use to compare against the current price — use amazon-jp:check-price-drops instead. Requires a connected shopper account (signed-in session). Returns action plus the stored watch entry with product_id, title, target_price, last_price, added_at, and last_checked_at. | |
Scopes define which services and APIs a key may call.
Retry rules and backoff behaviour for idempotent calls.
Receive events such as reservation confirmations and delivery updates.
| POST |
| /v1/amazon-jp/delete-price-watch |
| Delete the price watch for one product_id. Use when the user wants to stop tracking a product. Do NOT use to remove an item from the cart — use amazon-jp:remove-cart-item instead. Requires a connected shopper account (signed-in session). Returns action, removed, and product_id. |
| POST | /v1/amazon-jp/get-cart | Read the connected shopper's amazon.co.jp cart contents and subtotal. Use when the current cart state is needed before changing the cart or starting checkout. Do NOT use for the checkout estimated_total or notes — use amazon-jp:preview-checkout instead. Requires a connected shopper account (signed-in session). Returns items, subtotal, and item_count. |
| POST | /v1/amazon-jp/get-order | Read one amazon.co.jp order by order_id from the connected shopper's order history. Use when the user wants the details of one specific order, typically after amazon-jp:list-orders. Do NOT use to browse or list orders — use amazon-jp:list-orders instead. Requires a connected shopper account (signed-in session). Returns order_id, placed_at, total, ship_to, delivery, return_eligible, and items. |
| POST | /v1/amazon-jp/get-product | Read one amazon.co.jp product page by product_id, the public Amazon product identifier. Use when the product_id is already known and full detail is needed. Do NOT use for keyword discovery — use amazon-jp:search-products instead. Works without a connected account. Returns normalized product detail including title, url, image_url, price, brand, availability, points, delivery, and features. |
| POST | /v1/amazon-jp/list-orders | List recent amazon.co.jp orders for the connected shopper, up to the optional limit (default 10). Use when the user wants order history or needs an order_id to pass to amazon-jp:get-order. Do NOT use for one order's full detail — use amazon-jp:get-order instead. Requires a connected shopper account (signed-in session). Returns orders as normalized summaries with snake_case fields. |
| POST | /v1/amazon-jp/list-payment-methods | List saved payment methods for the connected shopper's amazon.co.jp account. Use when the user wants to see which payment choices are available before checkout. Do NOT use to get the checkout total — use amazon-jp:preview-checkout instead. Requires a connected shopper account (signed-in session). Returns methods with display name and description only; full card numbers are never exposed. |
| POST | /v1/amazon-jp/list-price-watches | List the price watches stored for the connected shopper. Use when the user wants to see which products are tracked and their last saved price snapshots. Do NOT use to fetch current prices or detect drops — use amazon-jp:check-price-drops instead. Requires a connected shopper account (signed-in session). Returns items, one watch entry per product_id with snake_case price-watch fields. |
| POST | /v1/amazon-jp/preview-checkout | Drive amazon.co.jp checkout to the final review stage without placing an order. Use when the user wants the estimated total and checkout notes for the current cart before deciding to buy. Do NOT use to read or change cart contents — use amazon-jp:get-cart, amazon-jp:add-cart-item, or amazon-jp:remove-cart-item instead. Never places an order; fails when the cart is empty. Requires a connected shopper account (signed-in session). Returns action, stage, cart, estimated_total, requires_confirmation, and notes. |
| POST | /v1/amazon-jp/remove-cart-item | Remove one product_id from the connected shopper's amazon.co.jp cart. Use only with explicit user intent to remove that specific item. Do NOT use to empty the whole cart — use amazon-jp:clear-cart instead. Requires a connected shopper account (signed-in session). Returns action, removed, and the updated cart. |
| POST | /v1/amazon-jp/search-products | Search the amazon.co.jp catalog by keyword with optional sort, min_price, and max_price filters. Use when the product is not yet known and must be discovered before calling amazon-jp:get-product or adding it to the cart. Do NOT use for a known product_id — use amazon-jp:get-product instead. Works without a connected account. Returns keyword, page, total, and products (summaries, each with product_id and snake_case fields). |
