logo
languageENdown
menu

Rakuten Product Details

Give a list of Rakuten product page URLs and get title, product ID, shop, listing status, and SKU details

Overview

Rakuten Product Details turns known Japanese product pages into one snapshot row per listing: title, product ID, shop, listing status, SKU text, and the page URL. Catalog and competitive-intelligence teams can compare Rakuten listings without opening each page.

The value is the product-page snapshot itself. Title, listing status, and SKU text stay in the source language, price strings inside SKU details keep their original numbers, and the URL you submitted sits on the same row as the no-data flag so you can see which targets resolved.

Data notes

Each record is a product-detail snapshot taken from the public Rakuten product page at collection time. Rows are deduplicated by the submitted product URL. Listing status and URL status are the page values recorded at collection time, not a live checkout state. SKU details stay as original source text, including price strings; the source does not state a currency. Collection time is stored as the source provided it and has no timezone. Created timestamp and Updated timestamp are Unix milliseconds.

Only public product pages that can be reached from a complete Rakuten product URL are covered. Unavailable or invalid pages can still appear as rows with the No-data flag set. Search results, reviews, sales history, and live inventory are not included.

What the results look like

Each record is one Rakuten product snapshot at collection time:

Product IDShop IDListing statusProduct URLSPU ID
10005020406191在售https://item.rakuten.co.jp/alice00/19rdv6003/19rdv6003
10000405346082在售https://item.rakuten.co.jp/store-ecovacs-japan/dkx55-12ee/dkx55-12ee

The result also includes Business ID, Submitted URL, Product title, Main image, SKU details, Collection time, Updated timestamp, URL status, and No-data flag.

Use cases

  • For catalog building, file Product ID, Product title, and Shop ID, and use Collection time to judge how fresh the snapshot is.
  • For competitive review, group by Shop ID and compare Product title, Listing status, and URL status.
  • For spec and price extraction, read SKU details and check Submitted URL with No-data flag to see which pages resolved.

Scope and boundaries

Submit at most 200 Rakuten product page URLs per run. Each URL returns one detail row or a no-data flag. Results are returned in a stable collection-time order. The app does not filter, aggregate, or custom-sort business fields.

  • Good for
  • When you need titles, product IDs, shops, listing status, and SKU details for a batch of known Rakuten product pages
  • When you want to keep product URLs, main images, and SKU text for later catalog or competitive analysis
  • Do not use for
  • When you need to discover products by keyword — this app only returns details for known product page URLs
  • When you need reviews, sales history, or historical prices — this app only returns a product-detail snapshot
  • When you need live checkout prices or live inventory — listing status and SKU prices are the page values recorded at collection time

Failure handling

Failure and retry behavior declared by the author. We recommend including it in your system prompt when integrating.

  1. 1If a row is marked as no data, check that the product page URL is complete and still publicly available
  2. 2If the run hits a rate limit, request timeout, or temporary service error, retry later with the same URL list
  3. 3If authentication fails, the task context does not match, or the task has expired, do not retry as-is; check the execution credentials or submit a new run
  4. 4If the task partially succeeds, completed product rows are still returned; failed and no-data counts are visible from the task status

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

FieldBusiness nameTypeRequiredDefaultEnum / ConstraintsExampleDescription
itemsProduct page URLsarray<object>Yes—up to 200 items[{"item":"https://item.rakuten.co.jp/alice00/19rdv6003/"}]Rakuten product pages to collect details for. Each entry is one complete product page URL. You can submit 1 to 200 items.

Output

Field structure of a single record, generated from the output.schema in manifest.json.

FieldBusiness nameTypeExampleDescription
biz_idBusiness IDstringhttps://item.rakuten.co.jp/alice00/19rdv6003/Business identifier for the Rakuten product-detail record, usually the product page URL
comment_countReview countstring0Review count text shown on the product page
crawl_timeCollection timestring2026-09-14T11:34:55Collection time text for the product snapshot; the source value has no timezone
created_atCreated timestampinteger1789356895498Unix millisecond timestamp when the record was created
itemSubmitted URLstringhttps://item.rakuten.co.jp/alice00/19rdv6003/Product page URL submitted for this detail row
job_typeCollection typestringBasicInfoCollection type text carried on the product-detail record
main_image_urlMain imagestring—Main product image URL; empty when the source has no image
platform_codePlatform codestringrakutenMarketplace platform code for the product
product_idProduct IDstring10005020Rakuten product identifier
product_titleProduct titlestringAnker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダーFull title shown on the product page
product_urlProduct URLstringhttps://item.rakuten.co.jp/alice00/19rdv6003/Product page URL
shop_idShop IDstring406191Shop identifier selling the product
skusSKU detailsstring[{"discount": null, "images": null, "originalPrice": "34500.0", "price": "34500.0", "skuId": "19rdv6003-00", "skuName": "ミッドナイトブラック"}, {"discount": null, "images": null, "originalPrice": "34500.0", "price": "34500.0", "skuId": "19rdv6003-01", "skuName": "シャンパンゴールド"}]SKU, price, and option text retained in the original source form
source_nameSource namestringrakuten_detail_202609Source dataset name carried on the detail record
spu_idSPU IDstring19rdv6003Standard product unit identifier for the listing
status_codeListing statusstring在售Sales status shown on the page at collection time
task_itemQuery itemstringhttps://item.rakuten.co.jp/alice00/19rdv6003/Submitted product page URL for this row, used as the stable record identifier
no_dataNo-data flagbooleanfalseWhether this product page produced no usable details
updated_atUpdated timestampinteger1789356895498Unix millisecond timestamp when the record was updated
url_statusURL statusstring有效Validity status of the product page URL at collection time

Record schema

Output is returned record by record. detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "biz_id": {
      "type": "string",
      "title": "Business ID",
      "description": "Business identifier for the Rakuten product-detail record, usually the product page URL",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "comment_count": {
      "type": "string",
      "title": "Review count",
      "description": "Review count text shown on the product page",
      "prefill": "0"
    },
    "crawl_time": {
      "type": "string",
      "title": "Collection time",
      "description": "Collection time text for the product snapshot; the source value has no timezone",
      "prefill": "2026-09-14T11:34:55"
    },
    "created_at": {
      "type": "integer",
      "title": "Created timestamp",
      "description": "Unix millisecond timestamp when the record was created",
      "prefill": 1789356895498
    },
    "item": {
      "type": "string",
      "title": "Submitted URL",
      "description": "Product page URL submitted for this detail row",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "job_type": {
      "type": "string",
      "title": "Collection type",
      "description": "Collection type text carried on the product-detail record",
      "prefill": "BasicInfo"
    },
    "main_image_url": {
      "type": "string",
      "title": "Main image",
      "description": "Main product image URL; empty when the source has no image"
    },
    "platform_code": {
      "type": "string",
      "title": "Platform code",
      "description": "Marketplace platform code for the product",
      "prefill": "rakuten"
    },
    "product_id": {
      "type": "string",
      "title": "Product ID",
      "description": "Rakuten product identifier",
      "prefill": "10005020"
    },
    "product_title": {
      "type": "string",
      "title": "Product title",
      "description": "Full title shown on the product page",
      "prefill": "Anker Soundcore Liberty 5 Pro Max 完全ワイヤレスイヤホン Bluetooth 6.1 ノイズキャンセリング LDAC ハイレゾ Dolby Atmos AIボイスレコーダー"
    },
    "product_url": {
      "type": "string",
      "title": "Product URL",
      "description": "Product page URL",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "shop_id": {
      "type": "string",
      "title": "Shop ID",
      "description": "Shop identifier selling the product",
      "prefill": "406191"
    },
    "skus": {
      "type": "string",
      "title": "SKU details",
      "description": "SKU, price, and option text retained in the original source form",
      "prefill": "[{\"discount\": null, \"images\": null, \"originalPrice\": \"34500.0\", \"price\": \"34500.0\", \"skuId\": \"19rdv6003-00\", \"skuName\": \"ミッドナイトブラック\"}, {\"discount\": null, \"images\": null, \"originalPrice\": \"34500.0\", \"price\": \"34500.0\", \"skuId\": \"19rdv6003-01\", \"skuName\": \"シャンパンゴールド\"}]"
    },
    "source_name": {
      "type": "string",
      "title": "Source name",
      "description": "Source dataset name carried on the detail record",
      "prefill": "rakuten_detail_202609"
    },
    "spu_id": {
      "type": "string",
      "title": "SPU ID",
      "description": "Standard product unit identifier for the listing",
      "prefill": "19rdv6003"
    },
    "status_code": {
      "type": "string",
      "title": "Listing status",
      "description": "Sales status shown on the page at collection time",
      "prefill": "在售"
    },
    "task_item": {
      "type": "string",
      "title": "Query item",
      "description": "Submitted product page URL for this row, used as the stable record identifier",
      "prefill": "https://item.rakuten.co.jp/alice00/19rdv6003/"
    },
    "no_data": {
      "type": "boolean",
      "title": "No-data flag",
      "description": "Whether this product page produced no usable details",
      "prefill": false
    },
    "updated_at": {
      "type": "integer",
      "title": "Updated timestamp",
      "description": "Unix millisecond timestamp when the record was updated",
      "prefill": 1789356895498
    },
    "url_status": {
      "type": "string",
      "title": "URL status",
      "description": "Validity status of the product page URL at collection time",
      "prefill": "有效"
    }
  },
  "required": [],
  "additionalProperties": false
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "super_ig__rakuten-product-detail": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/rakuten-product-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (The prompt asks the AI to request your API key from you, so credentials never end up in chat history or shared configs.)

detail.access.mcp.composeHint

Pricing

Start one product-detail task

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run
Return one product-detail record

Charged by the number of records successfully returned. Failed runs are not charged.

$0.004/ record

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
Please fill in the required parameters first
From $0.004 / record