Yodobashi Camera API & Scraper
Yodobashi Camera (ヨドバシカメラ) is Japan's largest electronics retailer and yodobashi.com its online store.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API reads it as JSON. `search` takes Japanese or English words or a category, narrows by maker and price range, sorts five ways, and returns 48 products per page with price including tax, the Gold Point reward (points and %), stock text, the delivery date, rating, review count and how many stores hold stock; sponsored listings come back separately. `product` returns the whole product page: price checked against the page's structured data, the maker's list price, the point reward as points, rate and yen value, the price after points, stock and delivery, category path and category ranks, rating, review and Q&A counts, images and the spec sheet. `reviews` returns every review of a product with its star rating and full text, `store_stock` the stock, price and pickup time in each Yodobashi store, and `ranking` a category's top 20 bestsellers.
What a Yodobashi field actually contains
Fields that read differently from how they look. Every row was measured against live yodobashi.com pages on 2026-10-14.
| Field | What it holds |
|---|---|
| sku | Yodobashi's 18-digit product number (100000001005925961), the number in yodobashi.com/product/<sku>/. Pass it unchanged to product, reviews and store_stock; a product URL works too. It is not a JAN barcode: yodobashi.com does not print the JAN, and the model number is part of the title. |
| price | Yen including consumption tax, as the page prints it with （税込）. It matched the page's structured data on every product checked. Products sold only in stores (some carrier iPhones) have price null and sales_status 店頭でのみ販売しています, never 0. |
| points, point_rate_pct, point_value_yen | The Gold Point reward printed under the price: 4,544 points, （10％還元） = 10 %, （￥4,544相当） = 4,544 yen. One Gold Point is worth one yen, and points equalled price × rate, rounded up, on every product checked (4,520 yen at 1 % = 46 points). Many products earn 10 %, some 1 % (game consoles, smartphones). |
| points_adjusted_price | price minus point_value_yen: what the product costs once the reward is counted (45,440 - 4,544 = 40,896). Yodobashi prints both numbers but not the subtraction; it is computed from them. |
| list_price, list_price_text | The maker's suggested retail price (希望小売価格) when the page prints one (￥1,078 above a 989 yen price); many products say オープンプライス (open price), returned in list_price_text with list_price null. |
| delivery_date, delivery_area | The delivery promise for yodobashi.com's default address 東京都新宿区 (Shinjuku, Tokyo), the same for every visitor. Other prefectures can get a different date. |
| rating_approx (search, ranking) | The star icon on the card, in quarter steps (4.5 for a product rated 4.61). The exact average is product.rating. |
| store_stock_count | How many Yodobashi stores hold stock (在庫のある店舗). It equalled the number of stores with in_stock true in store_stock on every product checked. |
Yodobashi shows the same price, points, stock and delivery promise to every visitor: one product read from three different countries in the same minute returned identical values. Prices are in yen including Japanese consumption tax.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/yodobashi/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "SSD"
}
}{
"ok": true,
"meta": {
"api": "yodobashi",
"endpoint": "search",
"mode": "live",
"latency_ms": 2667.8,
"record_count": 48,
"bytes": 381579,
"cache_hit": false,
"total": 3751,
"sponsored_count": 0,
"price_basis": "JPY, consumption tax included (the site prints （税込） next to every price)",
"delivery_basis": "delivery promise as yodobashi.com shows it for its default address 東京都新宿区 (Shinjuku, Tokyo); identical from every exit measured",
"pagination": {
"page": 1,
"last_page": 79,
"has_more": true
},
"upstream_requests": 1,
"charged_credits": 3,
"version": "0.1.0",
"request_id": "64d69d6ec07543c6",
"queue_ms": 1.1,
"fetched_at": "2026-10-14T18:57:35.504Z"
},
"data": {
"query": {
"query": "SSD",
"sort": "popular",
"include_discontinued": false,
"page": 1
},
"total": 3751,
"page": 1,
"last_page": 79,
"has_more": true,
"results": [
{
"sku": "100000001005925961",
"url": "https://www.yodobashi.com/product/100000001005925961/",
"title": "外付けSSD ポータブル Extreme Portable SSD（エクストリーム ポータブルSSD） 1TB USB 3.2（Gen 2）対応 5年保証 SDSSDE61-1T00-J25",
"brand": "サンディスク SANDISK",
"maker": "サンディスク",
"maker_code": "0000000713",
"release_date": "2020-12-18",
"image": "https://image.yodobashi.com/product/100/000/001/005/925/961/100000001005925961_10205.jpg",
"price": 45440,
"currency": "JPY",
"points": 4544,
"point_rate_pct": 10,
"stock_text": "在庫残少 ご注文はお早めに！",
"sales_status": null,
"delivery_text": "2026年10月16日金曜日までにヨドバシエクストリームサービス便がお届け",
"delivery_date": "2026-10-16",
"rating_approx": 4.5,
"review_count": 76,
"store_stock_count": 4,
"category": "外付けSSD",
"category_path": "19531/19532/19545/19667",
"tags": [
"値下げしました"
],
"sponsored": false
},
{
"sku": "100000001009081826",
"url": "https://www.yodobashi.com/product/100000001009081826/",
"title": "内蔵SSD WD_BLACK SN7100シリーズ M.2 2280 PCIe Gen 4.0 NVMe SSD 4TB 最大7,000MB/s読出 6,700MB/s書込 WDS400T4X0E",
"brand": "WESTERN DIGITAL ウェスタンデジタル",
"maker": "WESTERN DIGITAL",
"maker_code": "0000003600",
"release_date": "2025-05-09",
"image": "https://image.yodobashi.com/product/100/000/001/009/081/826/100000001009081826_10205.jpg",
"price": 109770,
"currency": "JPY",
"points": 10977,
"point_rate_pct": 10,
"stock_text": "在庫あり",
"sales_status": null,
"delivery_text": "2026年10月16日金曜日までにヨドバシエクストリームサービス便がお届け",
"delivery_date": "2026-10-16",
"rating_approx": 5,
"review_count": 2,
"store_stock_count": 3,
"category": "内蔵SSD",
"category_path": "19531/252001/252010",
"tags": null,
"sponsored": false
},
{
"sku": "100000001005925962",
"url": "https://www.yodobashi.com/product/100000001005925962/",
"title": "外付けSSD ポータブル Extreme Portable SSD（エクストリーム ポータブルSSD） 2TB USB 3.2（Gen 2）対応 5年保証 SDSSDE61-2T00-J25",
"brand": "サンディスク SANDISK",
"maker": "サンディスク",
"maker_code": "0000000713",
"release_date": "2020-12-18",
"image": "https://image.yodobashi.com/product/100/000/001/005/925/962/100000001005925962_10205.jpg",
"price": 70160,
"currency": "JPY",
"points": 7016,
"point_rate_pct": 10,
"stock_text": "在庫あり",
"sales_status": null,
"delivery_text": "2026年10月16日金曜日までにヨドバシエクストリームサービス便がお届け",
"delivery_date": "2026-10-16",
"rating_approx": 4.5,
"review_count": 76,
"store_stock_count": 19,
"category": "外付けSSD",
"category_path": "19531/19532/19545/19667",
"tags": [
"値下げしました"
],
"sponsored": false
}
],
"sponsored": [],
"maker_facets": [
{
"maker_code": "0000001565",
"name": "アイオーデータ I-O DATA",
"count": 254
},
{
"maker_code": "0000000997",
"name": "バッファロー BUFFALO",
"count": 230
},
{
"maker_code": "0000000034",
"name": "エイスース ASUS",
"count": 104
}
]
}
}What the Yodobashi Camera API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search yodobashi.com (ヨドバシ・ドット・コム) by keyword and/or category, optionally narrowed to one maker and a price range, in one of the site's five sort orders. 48 products per page (sponsored listings returned apart in `sponsored[]`, never mixed in) with price (tax included), Gold Point reward (points and %), stock text, the delivery promise, star rating (rounded icon), review count, how many stores hold stock, maker and release date. Needs `query` OR `category` (or both). Discontinued products are hidden unless `include_discontinued` is true, as on the site. | Pricing teams call search to search yodobashi.com (ヨドバシ・ドット・コム) by keyword and/or category, optionally narrowed to one mak…. | query, category, maker, min_price, max_price, ... |
| product | One yodobashi.com product page: title, brand, maker and maker code, sale start date, price (tax included, checked against the page's structured data), maker's list price or 'open price', Gold Point reward (points, rate %, yen value) and the points-adjusted price, stock text and structured availability, delivery promise and date (for the site's default Tokyo address), how many stores hold stock, rating, review and Q&A counts, number of variations, category path, rank in each category, notes, description, images and the full spec sheet. | Marketplace operators call product to get one yodobashi.com product page. | sku, url |
| reviews | Customer reviews of one product, newest first: star rating, full text, reviewer's public nickname, post time, when they bought it, likes, comments and helpful votes. Up to `limit` reviews in one call (all of them when limit ≥ the total). | Catalog enrichment teams call reviews to get customer reviews of one product, newest first. | sku, url, limit |
| store_stock | Stock of one product in every Yodobashi Camera store: store name, prefecture, address, phone, the store's price and points, in-stock flag and text (在庫あり / 残少 / お取り寄せ …), whether it is on display, and when an order can be picked up there. | Retail analysts call store_stock to get stock of one product in every Yodobashi Camera store. | sku, url |
| ranking | Yodobashi's bestseller ranking (ベストセラーランキング) of one category: the top 20 with rank, movement, days in the top 100, price, points, stock, delivery, rating and review count. The category is a path like `19531/19532/19545/19667` (a product's `category_ranks[].ranking_category`, or any `category_path`). | Pricing teams call ranking to get yodobashi's bestseller ranking (ベストセラーランキング) of one category. | category |
Call search from your stack
curl -X POST https://api.reefapi.com/yodobashi/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"SSD"}'import requests
r = requests.post(
"https://api.reefapi.com/yodobashi/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "SSD"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/yodobashi/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "SSD"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.yodobashi.search with {"query":"SSD"}.Who uses this API and why
- Track Yodobashi prices and Gold Point rates for a list of products every day, including the price after points.
- Compare a product's online price with the price and stock in each Yodobashi store.
- Monitor category bestseller rankings (SSDs, cameras, game consoles, notebooks) and rank movement.
- Collect Japanese customer reviews with star ratings for product research.
- Build a Japanese electronics catalogue with makers, sale start dates, categories and spec sheets.
Questions developers ask before integrating
Do I need a Yodobashi account?
No. Everything is read logged out, and you call reefapi.com from anywhere.
Can I search in Japanese?
Yes. Japanese and English words both work, and full-width letters are normalised: "ＳＳＤ" and "SSD" returned the same 3,752 products on 2026-10-14.
Which search filters are there?
Category, maker, price range, five sort orders and include_discontinued. Each was checked against the unfiltered count in the same run: "SSD" 3,752 → one maker 254, 10,000 to 20,000 yen 322 (48 of 48 rows in range), from 100,000 yen 1,296, category 外付けSSD 179, with discontinued products 18,866.
Are sponsored products mixed into the results?
No. Sponsored listings that sit in Yodobashi's result grid are returned in sponsored[], apart from results: 12 of them on page 1 of "掃除機" on 2026-10-14.
How many reviews does reviews return?
Up to 1,000 in one call, newest first. Nintendo Switch 2 returned all 297 reviews in one call on 2026-10-14 (its product page counted 298 at the same time). Each review has its star rating (null when the reviewer gave none), full text, nickname and post time.
What does store_stock return?
One row per Yodobashi store (42 on 2026-10-14): name, prefecture, address, phone, the store's price and points, in-stock flag and text, whether it is on display, pickup time and opening hours. A store's price can differ from the online price: one earphone was 3,150 yen online and 2,860 yen in two stores.
How deep does ranking go?
Yodobashi publishes the top 20 of each category, and ranking returns those 20 with rank movement and days in the top 100. product.category_ranks gives the rank in every category the product belongs to, also past 20.
Does the price depend on where I call from?
No. The same product read from three countries in the same minute returned the same price, points, stock and delivery date.
What is the Yodobashi Camera API?
Yodobashi Camera API is a ReefAPI endpoint group for japan's largest electronics retailer: prices with gold point rewards, stock and delivery date, reviews, stock in every store and bestseller rankings. It returns live JSON through POST requests under /yodobashi/v1.
Is the Yodobashi Camera API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Yodobashi Camera calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Yodobashi Camera login or account?
No login to Yodobashi Camera is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Yodobashi Camera data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Yodobashi Camera API use?
Yodobashi Camera actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Yodobashi Camera from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call yodobashi actions with the same key, credit pool and JSON envelope used by normal REST requests.