Service
ZOZOTOWN(zozo.jp) 카탈로그를 검색하고 가격, 매장, 색상, 사이즈, 이미지가 담긴 상품 상세와 관련 상품 추천을 조회하며, 알려진 상품들의 가격을 비교합니다. ZOZOTOWN 계정을 연결하면 계정, 장바구니, 즐겨찾기, 주문 내역을 조회하고 사용자를 대신해 주문을 취소하거나 반품할 수 있습니다.
83.15%30일 가동률평균 응답9656ms
행을 선택하면 해당 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. |
key가 호출할 수 있는 서비스와 API의 범위를 정의합니다.
멱등한 호출의 재시도 규칙과 backoff 동작을 설명합니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
지난 30일 동안 이 서비스에서 관측된 기록입니다.
| 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. |
