> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape one Rakuten Ichiba (Japan) item's full detail

> Fetches one Rakuten Ichiba item (by `product_id` '<shopCode>/<itemCode>' or `url`) and returns it as JSON: `itemId`, `itemCode`, `shopId` / `shopCode` / `shopName`, `url`, `title`, `tagline`, `description`, `condition`, `price` / `priceMax` (yen, tax included), `freeShipping`, `available`, `stockQuantity` (when the shop shares it), `deliveryMessage`, `orderLimit`, `rating`, `reviewCount`, `reviewsUrl`, `genreId`, `breadcrumbs`, `shopCategories`, `attributes` (name / value / unit), `variantOptions`, `variants` (every SKU with its options, price, availability, stock, JAN code and image) and `images`. The top-level price and stock are those of `variant_id` when given. Rakuten points are shown on search results (`/marketplace/rakuten-search`), not here. Companion to `/marketplace/rakuten-search`.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/rakuten-product
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /marketplace/rakuten-product:
    post:
      tags:
        - Plugins
      summary: Scrape one Rakuten Ichiba (Japan) item's full detail
      description: >-
        Fetches one Rakuten Ichiba item (by `product_id` '<shopCode>/<itemCode>'
        or `url`) and returns it as JSON: `itemId`, `itemCode`, `shopId` /
        `shopCode` / `shopName`, `url`, `title`, `tagline`, `description`,
        `condition`, `price` / `priceMax` (yen, tax included), `freeShipping`,
        `available`, `stockQuantity` (when the shop shares it),
        `deliveryMessage`, `orderLimit`, `rating`, `reviewCount`, `reviewsUrl`,
        `genreId`, `breadcrumbs`, `shopCategories`, `attributes` (name / value /
        unit), `variantOptions`, `variants` (every SKU with its options, price,
        availability, stock, JAN code and image) and `images`. The top-level
        price and stock are those of `variant_id` when given. Rakuten points are
        shown on search results (`/marketplace/rakuten-search`), not here.
        Companion to `/marketplace/rakuten-search`.
      operationId: rakuten_product_marketplace_rakuten_product_post
      parameters:
        - name: product_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              The item as '<shopCode>/<itemCode>', e.g. 'dai-one/15-128-a' (the
              two path parts of an item link; search results give them as
              `shopCode` and `itemCode`).
            title: Product Id
          description: >-
            The item as '<shopCode>/<itemCode>', e.g. 'dai-one/15-128-a' (the
            two path parts of an item link; search results give them as
            `shopCode` and `itemCode`).
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Instead of `product_id`: a Rakuten item link, e.g.
              https://item.rakuten.co.jp/dai-one/15-128-a/ (a `variantId` in it
              is used).
            title: Url
          description: >-
            Instead of `product_id`: a Rakuten item link, e.g.
            https://item.rakuten.co.jp/dai-one/15-128-a/ (a `variantId` in it is
            used).
        - name: variant_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              SKU whose price and stock fill the top-level fields, e.g.
              'r-sku00003161'; by default the item's lowest price and overall
              availability. Every SKU is listed in `variants` either way.
            title: Variant Id
          description: >-
            SKU whose price and stock fill the top-level fields, e.g.
            'r-sku00003161'; by default the item's lowest price and overall
            availability. Every SKU is listed in `variants` either way.
      responses:
        '200':
          description: JSON with the full item record.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid or missing product_id/url.
        '404':
          description: No such item (Rakuten shows its error page).
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            No usable answer from Rakuten on every attempt, or the call did not
            finish in time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.