Service
Search products on Yahoo! Shopping Japan (ItemSearch V3): keyword, category, JAN barcode, and store-scoped search with normalized prices, reviews, stock, and seller data.
100.00%30-day uptimeAvg response322ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/yahoo-shopping-jp/search-products-by-category | Lists Yahoo! Shopping Japan products within a Yahoo genre category, identified by its numeric genre_category_id, with pagination. Use to browse a category tree after discovering a genre_category_id from search results. Do NOT use for free-text search — use yahoo-shopping-jp:search-products-by-keyword instead. Returns the same normalized listing shape as keyword search (hits plus total_results_available). | |
| POST | /v1/yahoo-shopping-jp/search-products-by-jan-code | Finds all Yahoo! Shopping Japan listings carrying a specific JAN/EAN barcode (8 or 13 digits). Because one barcode maps to one product, this returns competing seller offers for price comparison. Do NOT use for product names or free-text queries — use yahoo-shopping-jp:search-products-by-keyword instead. An unknown barcode returns zero hits, not an error. Returns the normalized listing shape (hits plus total_results_available). | |
| POST | /v1/yahoo-shopping-jp/search-products-by-keyword | Searches Yahoo! Shopping Japan for products matching a free-text keyword, with optional sorting and pagination. Use for marketplace-wide product discovery and comparison; a no-match query returns zero hits, not an error. Do NOT use when you already have a JAN/EAN barcode — use yahoo-shopping-jp:search-products-by-jan-code instead; do NOT use to browse a single store's catalog — use yahoo-shopping-jp:search-products-by-store instead; do NOT use to browse a Yahoo genre category by id — use yahoo-shopping-jp:search-products-by-category instead. Returns hits (normalized listings with name, price in JPY, review summary, stock, condition, category, brand, seller) plus total_results_available for onward paging. | |
| POST | /v1/yahoo-shopping-jp/search-products-by-store | Lists products from a specific Yahoo! Shopping Japan seller (store), identified by seller_id, optionally filtered by an in-store keyword and stock availability. Use to browse or search a single store's catalog. Do NOT use for marketplace-wide search — use yahoo-shopping-jp:search-products-by-keyword instead. Returns the normalized listing shape (hits plus total_results_available). |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
