Service
Search the ZOZOTOWN (zozo.jp) catalog, read product detail with price, shop, colors, sizes, and images, get related product recommendations, and compare the prices of known goods. With a connected ZOZOTOWN account, read the shopper's account, cart, favorites, and order history, and cancel or return orders on their behalf.
84.17%30-day uptimeAvg response9338ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/zozotown/account | Reads the connected shopper's ZOZOTOWN account state from the member BFF: login status, member id, cart count, and favorite count. Use to confirm the session and show a summary. Do NOT use to read full cart or favorites contents — use zozotown:cart-list or zozotown:favorites-list instead. Returns loggedIn, memberId, cartCount, favoriteCount. Requires a logged-in cookie session. | |
| POST | /v1/zozotown/cart-list | Reads the connected shopper's ZOZOTOWN cart contents and subtotal. Use to show what is in the cart before checkout. Do NOT use to read order history — use zozotown:order-list instead. Returns items (did/price/quantity; name, brand, color, size, and imageUrl are not readable from this page and are null), subtotal, and itemCount. Requires a logged-in cookie session. | |
| POST | /v1/zozotown/favorites-list | Reads the connected shopper's saved ZOZOTOWN favorites (お気に入り). Use to list saved items and their favorite ids. Do NOT use to read the cart — use zozotown:cart-list instead. Returns items (did/favoriteId/url; goodsId, name, brand, detail, price, imageUrl, and isSoldOut are not readable from this page and are null) and count. Requires a logged-in cookie session. | |
| POST | /v1/zozotown/order-cancel | Cancels a not-yet-shipped ZOZOTOWN order (preship and within 60 minutes of ordering only). Use only with explicit user intent to cancel a real order. Do NOT call speculatively or after dispatch; for a shipped order use zozotown:order-return instead. Returns oid, cancelled, status (cancelled / not_cancellable / not_found / requires_browser / failed), and message. Destructive: cancels a real order; upstream cancellability (ng_reason_id_for_cancellation) is checked first. | |
| POST | /v1/zozotown/order-detail | Reads one ZOZOTOWN order by oid: order number, date, shipping status, payment method, return eligibility, and line items. Use after zozotown:order-list to inspect a specific order. Do NOT use to list orders — use zozotown:order-list instead. Returns the normalized order. Requires an order id from the shopper's own history. |
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.
Observed on this service over the last 30 days.
| POST | /v1/zozotown/order-list | Lists the connected shopper's ZOZOTOWN orders for one ship type (shipped or preship). Use to show purchase history, shipping status, and return eligibility, or to pick an order id for zozotown:order-detail. Do NOT use to read a single order's full detail — use zozotown:order-detail instead. Returns shipType and an orders array. Requires a logged-in cookie session. |
| POST | /v1/zozotown/order-return | Files a return/exchange request for a shipped ZOZOTOWN order (shipped and within the return window only). Use only with explicit user intent to return a real order. Do NOT use to cancel a preship order — use zozotown:order-cancel instead. Returns oid, submitted, status (submitted / not_returnable / not_found / requires_browser / failed), and message. Destructive: files a real return; reasonId defaults to 0, and the detailed return reason and refund bank details are collected by ZOZOTOWN's own chatbot flow, not by this operation. |
| POST | /v1/zozotown/price-compare | Compares up to five caller-selected ZOZOTOWN goods ids side by side in input order. Use to compare the current prices of several known goods ids at once. Do NOT use to read one product — use zozotown:product-detail instead; do NOT use for keyword discovery — use zozotown:search instead. Each row carries the current JPY price as amount and currency, shop_name, a physical-store stock signal, and price disclaimer text; optional positional shop_slugs only add canonical URLs and never change fetched product data. list_price and is_sold_out are not exposed by this source and are always null. Returns comparisons (one row per requested id with resolution_status and failure_code), is_partial (true when any row is unresolved or carries a failure_code), and cheapest_product_id (set only when every row and price resolved, otherwise null). |
| POST | /v1/zozotown/product-detail | Reads one ZOZOTOWN product by goodsId. Use to inspect a single known item. Do NOT use for keyword discovery — use zozotown:search instead. Returns goodsId, name, price, shopName, colors, favoriteCount, attributeTags, and url (the canonical URL when shop_slug from search is supplied, otherwise null); sizes, images, and relatedProducts are included only when the matching optional BFF ids are supplied together. Public read; per-size stock is not exposed by ZOZO. |
| POST | /v1/zozotown/product-recommendations | Returns related products for one ZOZOTOWN goods id (product_id). Use after zozotown:search or zozotown:product-detail to discover similar catalog items. Do NOT use to read the product itself — use zozotown:product-detail instead; do NOT use to compare prices — use zozotown:price-compare instead. All three upstream gender segments are queried and merged so products are not silently lost, then deduplicated by product_id in first-seen order. Returns products (normalized, with JPY price and coupon_discount as amount and currency) and is_partial (true when any segment could not be read). |
| POST | /v1/zozotown/search | Searches the ZOZOTOWN catalog by keyword with optional sort. Use to find fashion products before reading detail. Do NOT use to read a known goodsId — use zozotown:product-detail instead. Returns keyword, page, hitCount, and a products array (goodsId/detailId/shopSlug/name/brand/url/price/listPrice/discountPercent/isSoldOut). Public read; the keyword must be representable in Shift-JIS (ZOZOTOWN's search encoding) or the request is rejected, and Akamai anti-bot challenges may occasionally block a request. |
