APIFuseAPIFuse
문서서비스플레이그라운드상태
로그인회원가입

Service

Yahoo! Shopping (Japan)

일본, 커머스제공 중
Playground에서 시험API 레퍼런스 열기

Overview

야후! 쇼핑 재팬(ItemSearch V3)에서 상품을 검색합니다. 키워드, 카테고리, JAN 바코드, 스토어 범위 검색을 지원하며 정규화된 가격, 리뷰, 재고, 판매자 정보를 함께 제공합니다.

Status

정상

100.00%30일 가동률평균 응답369ms

2026-09-012026-10-112026-10-25

Setup

Auth mode
Managed key
Credentials
  • yahoo-shopping-jp scope가 허용된 managed key
Sandbox
미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

MethodAPIPathSummary
POST/v1/yahoo-shopping-jp/search-products-by-categoryLists 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-codeFinds 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-keywordSearches 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-storeLists 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).

Related guides

  • sandbox key를 발급받고 첫 예약 생성까지 진행합니다.

  • 파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.

  • 예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.

  • 서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.

카테고리로 상품 검색
JAN 코드로 상품 검색
키워드로 상품 검색
스토어로 상품 검색
빠른 시작
Managed key
개요
에러 모델