Qoo10 Japan as JSON: prices, coupon prices, stock and rankings
Qoo10 (qoo10.jp) is eBay Japan's marketplace, strong in Korean cosmetics, fashion and electronics, with thousands of shops and frequent Mega Wari coupon events.
5 active endpoints. Every call is 3 credits.
- POST/qoo10/v1/search
- POST/qoo10/v1/product
- POST/qoo10/v1/shop
- POST/qoo10/v1/ranking
- POST/qoo10/v1/categories
What Qoo10 Japan endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Qoo10 Japan API
3 of 5 endpoints, ready to run
Search qoo10.jp with sale price, coupon price and shop
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the Qoo10 Japan API works
Qoo10 Japan is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 585 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a keyword to the cheapest offer after coupons
Search all shops, then open the items you care about.
40 items per page with sale price, struck price, coupon price and label, Q-points, rating, ship-from country and shop.
The price range applies to the sale price; last_page tells how many pages the narrowed query has.
Sale and list price, discount type, coupon price with the page's own breakdown, stock per option, shipping fee and the seller's rating.
A dated offer list across Qoo10 shops: sale price, coupon price, stock and shipping per shop.
curl -X POST https://api.reefapi.com/qoo10/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone"}'{
"ok": true,
"data": { … },
"meta": {
"api": "qoo10",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Qoo10 field actually contains
Fields that read differently from how they look. Every row was measured against live qoo10.jp pages on 2026-10-18.
| Field | What it holds |
|---|---|
| price | The sale price in yen, consumption tax included, before any coupon: what the item page charges. Search row, item page and the page's own price figure agreed on 9 of 9 items checked across three searches. |
| coupon_price, coupon_price_label, coupon_price_type | The lower figure Qoo10 prints next to the price once a coupon is applied, with the site's own label: ショップ割時 (shop coupon, shop_coupon), メガデビュー時 (first-purchase Mega Debut coupon, mega_debut), メガ割時 (Mega Wari, mega_wari), メガポ時 (Mega Point, mega_point). It is never put in price. Example: price 2,840 yen, coupon_price 1,988 yen, Mega Debut. |
| price_breakdown (product) | The item page's own lines: 販売価格 (list price), 一般割引 (general discount), ショップ商品クーポン (shop item coupon) and the resulting maximum-discount price. 3,000 − 600 − 216 = 2,184 on the item checked. |
| struck_price, price_drop (search) | A card that prints "2,700円 (150円 ↓)" shows a drop from the item's recent selling price; struck_price equalled the item page's recent_min_price on 5 of 5 items. A card without the arrow strikes the seller's list price. |
| recent_min_price, list_price (product) | list_price is the seller's set price (販売価格); recent_min_price is the item's recent minimum selling price that the search card strikes through. They can differ: 3,300 and 2,700 on the same item. |
| price_is_placeholder | True for rows priced 999,999,999 yen, a placeholder some sellers use for items they are not selling. A price-high-to-low search for iphone started with 40 of them. |
| variants[].stock, option_levels | Stock and price difference for each option as the item page publishes it. For two-level options (type, then size) the site sends the second level only after a choice; stock is then null, not 0, and option_levels_read is lower than option_levels. |
| ld_price_is_coupon_price | The page's structured data sometimes carries the coupon price instead of the sale price (1 of 9 items checked). This flag says so; price stays the sale price. |
Prices are in yen including Japanese consumption tax. The same item and the same search read from four different countries in the same minute returned the same prices, currency, shipping fee and rows.
Qoo10 Japan coverage, measured
Every number below was read from live qoo10.jp responses on 2026-10-18, in three runs of 54 calls.
Japan, prices in yen including consumption tax. 11 category groups with 61 large and 523 medium categories; ranking 200 for the site's 12 tabs (3 read on the day, 200 items each).
Category: 40 of 40 rows in the asked category, none shared with the unfiltered page. Price 100,000 to 150,000 yen: 50 pages → 11, 40 of 40 rows in range. Sorts: price low to high started at 99 yen.
Search row, item page and the page's own price figure agreed on 9 of 9 items; the page's structured data agreed on 8 of 9 and carried the coupon price on the ninth (flagged).
item_id and shop id from search opened the same item and shop in product on 9 of 9 items; pages 1, 2 and 3 shared no organic item.
50 pages of 40 items per query and no result count; Mega Wari prices appear only while an event runs; the second level of two-level options and the full review list are not returned; Qoo10 sites outside Japan are not covered.
What people build with Qoo10 Japan
The jobs this data is most often used for.
endpoints
credits per call
Track the sale price, coupon price and Mega Wari price of Korean cosmetics across Qoo10 shops.
Monitor stock per option and order limits for a list of items every day.
Follow the Qoo10 ranking 200 by category to spot fast-moving products.
Compare a brand's official shop with resellers on price, shipping and seller rating.
What Qoo10 Japan data costs
The cheapest call here is 3 credits, so $15/mo (Pro) buys 3,333 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 585 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/qoo10/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone"}'import requests
r = requests.post(
"https://api.reefapi.com/qoo10/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Qoo10 Japan.
Get a free key →Do I need a Qoo10 account or seller API key?▾
No. Everything is read logged out from the public qoo10.jp site, and you call reefapi.com from anywhere. The Qoo10 seller API (QAPI) is not involved.
Can I get the Mega Wari price?▾
Yes when the page prints it: coupon_price with coupon_price_type mega_wari, kept apart from price. Mega Wari was not running on 2026-10-18; shop-coupon and Mega Debut prices were measured live that day (5 of 40 rows on one page carried a coupon price).
Which search filters are there?▾
Category, price range and five sort orders (ranking, price low to high, price high to low, most reviewed, newest). On 2026-10-18 "iphone" in category 220000285 returned 40 of 40 rows in that category and none of the unfiltered page; 100,000 to 150,000 yen cut the pages from 50 to 11 with 40 of 40 rows in range.
Does the price filter use the coupon price?▾
No. Qoo10 filters on the sale price: a 2,200 to 2,400 yen search returned 40 of 40 rows with price in range, two of them with a coupon price below 2,200.
How many results can I read?▾
40 items per page, up to 50 pages per query: the site's own pager. Qoo10 publishes no result count, so last_page (at most 50) is the size signal. Narrow with a category or price range to reach more items.
Are sponsored items mixed into the results?▾
No. The 8 PR rows on a ranking-order page are returned in sponsored[], apart from the 40 organic results. Sorted pages carried none.
Can I list everything one shop sells?▾
Yes, shop takes the shop id from any search row and returns 60 items per page in the same five orders; the medicube shop had 73 items over 2 pages.
What happens with an item that no longer exists?▾
product answers NOT_FOUND. A query with no match answers an empty results list.
What is the Qoo10 Japan API?▾
Qoo10 Japan API is a ReefAPI endpoint group for search qoo10.jp and read any item: sale price, list price, coupon and mega wari price apart, q-points, shipping, stock per option and seller rating. It returns live JSON through POST requests under /qoo10/v1.
Is the Qoo10 Japan API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Qoo10 Japan calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Qoo10 Japan login or account?▾
No login to Qoo10 Japan 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 Qoo10 Japan 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 Qoo10 Japan API use?▾
Qoo10 Japan actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Qoo10 Japan from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call qoo10 actions with the same key, credit pool and JSON envelope used by normal REST requests.
320 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Qoo10 Japan, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 584 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-18.