rakuten-ichiba — Rakuten Ichiba Item Search API (gated)
Official Rakuten Web Service. Requires RAKUTEN_APP_ID (free application id); applications created since the 2026-07-01 API version also need RAKUTEN_ACCESS_KEY (when present the openapi.rakuten.co.jp/…/20260701 endpoint is used, otherwise the legacy app.rakuten.co.jp/…/20220601). Until a key exists the framework reports the connector DISABLED.
- Request:
keywordper seed,hits=30,page,sort=-updateTimestamp,formatVersion=2,imageFlag=1; credentials redacted from stored URLs; 1 req/s. - Response
{ count, page, pageCount, Items[] }— both formatVersion 1 ({ Item: {…} },[{ imageUrl }]) and 2 (flat, string URLs) are accepted. - Output: JPY
listingper item (shop asking price),identifiers.rakuten_item_code, shop name as seller, availability, sale window, PSA grade / condition / bundle hints from the Japanese title. - Fixture
docs-format-v2.jsonis built from the documented response format (not a live capture) — replace with a live capture once a key exists.