# 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: `keyword` per 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 `listing` per 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.json` is built from the documented response format (not a live capture) — replace with a live capture once a key exists.