nvNeuralVerge
E-commerce & Marketplaces

Rakuten Shop Catalog — All Items of a Rakuten Ichiba Shop

Send a Rakuten shop code, or the shop URL, and this source returns the shop's item catalog as data: title, price range, image, point value, shipping flag, rating, review count and category for each item.

Example response
{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "rakuten_shop_items",
  "shop": "sawaicoffee-tea",
  "shop_code": "sawaicoffee-tea",
  "max_items": 2,
  "start_page": 1,
  "partial": false,
  "human": "# Rakuten shop items\n\n- **Shop:** sawaicoffee-tea\n- **Starting page:** 1\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 2.33 MB",
  "machine": {
    "total_items": 2,
    "first_item": {
      "id": "sawaicoffee-tea/osechi-200set",
      "item_code": "osechi-200set",
      "url": "https://item.rakuten.co.jp/sawaicoffee-tea/osechi-200set/",
      "title": "澤井珈琲|コーヒー 送料無料 ドリップバッグ 珈琲 \"みんなで楽しめる大容量ドリップパック\" ドリップコーヒー 10種 200袋 セット 福袋 おせち コスパ最強 飲み比べ 簡単 手軽 個包装 ブラジル グアテマラ 中煎り~深煎り エチオピア 多彩なブレンド 【RD】 【TS】",
      "subtitle": "職場の休憩に 自宅でカフェ気分 家でも職場でも 手間なく抽出 贅沢アソート いろいろなコーヒーを楽しみたい 職場で手軽にコーヒーを飲みたい やわらかさから力強さまで 食後の一杯に",
      "image": "https://thumbnail.image.rakuten.co.jp/@0_mall/sawaicoffee-tea/cabinet/thum/ff26/osechi-200set_01.jpg",
      "price": 15980,
      "price_max": 15980,
      "currency": "JPY",
      "point": 294,
      "is_free_shipping": true,
      "is_sold_out": false,
      "rating": 4.82,
      "review_count": 3445,
      "category_id": 506539,
      "category": "ドリップバッグ・コーヒーバッグ",
      "genre_breadcrumbs": [
        "水・ソフトドリンク",
        "コーヒー"
      ],
      "shop": {
        "id": 198667,
        "name": "澤井珈琲Beans&Leaf",
        "alias": "sawaicoffee-tea"
      }
    },
    "items": [
      {
        "id": "sawaicoffee-tea/osechi-200set",
        "item_code": "osechi-200set",
        "url": "https://item.rakuten.co.jp/sawaicoffee-tea/osechi-200set/",
        "title": "澤井珈琲|コーヒー 送料無料 ドリップバッグ 珈琲 \"みんなで楽しめる大容量ドリップパック\" ドリップコーヒー 10種 200袋 セット 福袋 おせち コスパ最強 飲み比べ 簡単 手軽 個包装 ブラジル グアテマラ 中煎り~深煎り エチオピア 多彩なブレンド 【RD】 【TS】",
        "subtitle": "職場の休憩に 自宅でカフェ気分 家でも職場でも 手間なく抽出 贅沢アソート いろいろなコーヒーを楽しみたい 職場で手軽にコーヒーを飲みたい やわらかさから力強さまで 食後の一杯に",
        "image": "https://thumbnail.image.rakuten.co.jp/@0_mall/sawaicoffee-tea/cabinet/thum/ff26/osechi-200set_01.jpg",
        "price": 15980,
        "price_max": 15980,
        "currency": "JPY",
        "point": 294,
        "is_free_shipping": true,
        "is_sold_out": false,
        "rating": 4.82,
        "review_count": 3445,
        "category_id": 506539,
        "category": "ドリップバッグ・コーヒーバッグ",
        "genre_breadcrumbs": [
          "水・ソフトドリンク",
          "コーヒー"
        ],
        "shop": {
          "id": 198667,
          "name": "澤井珈琲Beans&Leaf",
          "alias": "sawaicoffee-tea"
        }
      },
      {
        "id": "sawaicoffee-tea/yakumoice160",
        "item_code": "yakumoice160",
        "url": "https://item.rakuten.co.jp/sawaicoffee-tea/yakumoice160/",
        "title": "\先着300円OFFクーポン配布/ 送料無料 コーヒー 珈琲 コーヒー豆 水出し珈琲 \"甘味香る芳醇のアイスコーヒー\" 澤井珈琲 ブレンドやくもアイス 400g×3袋 濃厚で爽やか 芳醇な味わい リピート 大満足 迅速配送 水出し簡単 【RD】 【TS】",
        "subtitle": "仕事の合間や家事のあとにほっと一息。手軽に淹れて本格的な味わい。香ばしい深みとすっきりした後味で、毎日のリラックスタイムを豊かに彩る一杯です。",
        "image": "https://thumbnail.image.rakuten.co.jp/@0_mall/sawaicoffee-tea/cabinet/thum/ff26/yakumoice120_t_01.jpg",
        "price": 8998,
        "price_max": 8998,
        "currency": "JPY",
        "point": 166,
        "is_free_shipping": true,
        "is_sold_out": false,
        "rating": 4.54,
        "review_count": 37,
        "category_id": 201402,
        "category": "コーヒー豆",
        "genre_breadcrumbs": [
          "水・ソフトドリンク",
          "コーヒー"
        ],
        "shop": {
          "id": 198667,
          "name": "澤井珈琲Beans&Leaf",
          "alias": "sawaicoffee-tea"
        }
      }
    ],
    "not_found": false,
    "proxy_traffic_bytes": 2441602
  },
  "total_points": 2
}
You send
A Rakuten shop code or shop URL
You get back
The shop's items with title, price range, image, points, shipping, rating and category
Coverage
Items listed in a Rakuten Ichiba shop's public catalog.
Price
1 point per returned record, up to 500 per request — $1 per 1,000
Billed per record actually returned, capped by max_items. A shop with no items costs nothing.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
Browsing the shop by handPage through the storefront and copy what you needFree, and slowA large shop is hours of copying and goes stale quickly
Building a scraperWrite it, host it, and repair it when Rakuten changes the shop pagesEngineering timeA maintenance commitment for something that isn't your product
NeuralVergeOne request per shop, max_items and start_page as parameters$1 per 1,000, misses not billedA big catalog is a big bill if you don't set max_items
Response

What you get back

Every field in the response shown above.

FieldTypeDescription
total_itemsnumberHow many items were returned in this batch (capped by max_items).
first_itemobjectThe first item, repeated outside the list for quick checks.
items[].idstringItem identifier in shop_code/item_code form.
items[].item_codestringThe item code within the shop.
items[].urlstringDirect link to the item page.
items[].titlestringListing title.
items[].subtitlestringCatch-copy line under the title, when the shop sets one.
items[].imagestringThumbnail image URL.
items[].pricenumberLowest listed price.
items[].price_maxnumberHighest listed price across variants.
items[].currencystringISO currency code, e.g. JPY.
items[].pointnumberPoints shown for the item.
items[].is_free_shippingbooleanWhether the item ships free.
items[].is_sold_outbooleanWhether the item is sold out.
items[].ratingnumberAverage star rating.
items[].review_countnumberNumber of reviews.
items[].category_idnumberRakuten genre ID of the item's category.
items[].categorystringCategory name.
items[].genre_breadcrumbsarrayParent genre names above the category.
items[].shopobjectShop id, name and alias (the shop code).
not_foundbooleanWhether the shop could not be found.
Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

shop is the only required field. max_items caps the result count (up to 500, defaults to 10) and sets what you're billed for; start_page lets you continue from a later page.

curl -X POST https://api.neuralverge.ai/functions/v1/run-rakuten-shops-items \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "shop": "sawaicoffee-tea", "max_items": 25 }'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Competitor catalog tracking

Re-run on a schedule to see new items and price changes.

Supplier assessment

See a shop's range, price points and ratings before you work with it.

Assortment mapping

Group a shop's items by category to see where it concentrates.

Feeding item lookups

Collect shop_code/item_code IDs, then pull variants with Rakuten item.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Items listed in a Rakuten Ichiba shop's public catalog.

Freshness

Read at request time.

Handling

This source returns publicly visible catalog information, stamped with the shop it was read from and a session id you can trace.

What it will not do
  • —Price, points and stock reflect the moment of the request and can change right after.
  • —Listings give a price range, not per-variant prices; use Rakuten item for variants.
  • —Titles are as long as the shop wrote them, which on Rakuten is often very long.
FAQ

Questions, answered

Up to 500 items per request. Use start_page to continue from a later page for a larger shop.

Related

Related sources

Try rakuten shop items on your own data

One request format across every source in the catalog.

Get started