# yahoo-shopping-jp — Yahoo! Shopping itemSearch V3 (gated)

Official Yahoo! JAPAN Web API. Requires YAHOO_JP_APP_ID (free Client ID). Until it exists the framework reports the connector DISABLED.

Request: shopping.yahooapis.jp/ShoppingWebService/V3/itemSearch?appid=…&query=<kw>&results=50&start=<n>&image_size=600[&condition=used|new]; start + results ≤ 1000 (≤ 20 pages per seed); 1 query/s (429 beyond); app id redacted from stored URLs.
Output: JPY listing per hit — code, name, url, price, new/used condition, stock flag, JAN code → identifiers.jan / ean, brand, store (seller), genre category, release date, image.
Fixture docs-sample-nike.json is the documentation's own sample response (query=nike), not a live capture.