Japan's auction marketplace as JSON, including what things actually sold for
The Yahoo! Auctions Japan API turns auctions.yahoo.co.jp (ヤフオク!) into clean JSON in seven actions.
7 active endpoints. Every call is 1 credit.
- POST/yahoo-auctions/v1/search
- POST/yahoo-auctions/v1/sold/search
- POST/yahoo-auctions/v1/product/detail
- POST/yahoo-auctions/v1/seller/listings
- POST/yahoo-auctions/v1/category/products
- POST/yahoo-auctions/v1/categories
- POST/yahoo-auctions/v1/suggest
What Yahoo! Auctions Japan endpoints does ReefAPI ship?
7 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Yahoo! Auctions Japan API
3 of 7 endpoints, ready to run
Live Yahoo! Auctions listings: auction id, title, image, current and buy-now price with tax included, bids and watchers, end time, condition, category path, where it ships from, the shipping fee to your prefecture and the seller's rating.
{ "ok": true, "meta": { "api": "yahoo-auctions", "endpoint": "search", "mode": "live", "latency_ms": 1390.1, "record_count": 50, "cache_hit": false }, "data": { "items": [ { "auction_id": "e1242974944", "title": "ガーディ(1ED)(004/020) U ポケモンカードゲーム", "url": "https://auctions.yahoo.co.jp/jp/auction/e1242974944", "image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0209/user/4de85e37f2cc010ee64b5d765ea5758a79581da8e31f1e79dbb068181bd11d56/i-img1200x900-17883208129169jw1yk57487.jpg?pri=l&w=300&h=300&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "price": 3080, "buy_now_price": null, "buy_now_price_excluding_tax": null, "start_price_excluding_tax": 2800, "currency": "JPY", "bid_count": 1, "watch_count": 0, "quantity": 1, "is_fixed_price": false, "listing_type": "store", "condition": "fair", "condition_code": "USED40", "category": { "id": 2084317608, "name": "シングルカード", "path": [ { "id": 25464, "name": "おもちゃ、ゲーム" }, { "id": 27727, "name": "ゲーム" }, { "id": 25826, "name": "トレーディングカードゲーム" } ] }, "brand_id": 167473, "catalog_id": "6b7c68c3d4", "item_location": { "code": 36, "name": "徳島県" }, "free_shipping": false, "shipping_fee": 250, "shipping_fee_type": "PROPORTIONAL_WEIGHT", "shipping_fee_timing": "fixed", "buy_now_shipping_fee": null, "is_featured": false, "is_new_arrival": false, "is_appraised": false, "easy_payment": false, "start_time": "2026-09-14T13:41:26Z", "end_time": "2026-09-16T13:41:26Z", "rating": null, "review_count": null, "rating_scale": null }, { "auction_id": "v1230972619", "title": "ポケモンカード ヒヤッキー XY1 020/060 同梱OK (9114)", "url": "https://auctions.yahoo.co.jp/jp/auction/v1230972619", "image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0205/user/b67a078f70bf6b859386ac58d02c03637a96d7bee770081eca5fb2a0351e40c4/i-img749x1051-17795524607599ado2uf71402.jpg?pri=l&w=300&h=300&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "price": 50, "buy_now_price": null, "buy_now_price_excluding_tax": null, "start_price_excluding_tax": 50, "currency": "JPY", "bid_count": 0, "watch_count": 0, "quantity": 1, "is_fixed_price": false, "listing_type": "individual", "condition": "worn", "condition_code": "USED60", "category": { "id": 2084317608, "name": "シングルカード", "path": [ { "id": 25464, "name": "おもちゃ、ゲーム" }, { "id": 27727, "name": "ゲーム" }, { "id": 25826, "name": "トレーディングカードゲーム" } ] }, "brand_id": 167473, "catalog_id": "7e8484168d", "item_location": { "code": 12, "name": "千葉県" }, "free_shipping": false, "shipping_fee": null, "shipping_fee_type": null, "shipping_fee_timing": "decided_after_sale", "buy_now_shipping_fee": null, "is_featured": false, "is_new_arrival": true, "is_appraised": false, "easy_payment": true, "start_time": "2026-09-15T13:41:26Z", "end_time": "2026-09-16T13:41:26Z", "rating": null, "review_count": null, "rating_scale": null }, { "auction_id": "q1208197079", "title": "ポケモンカード アクア団のトドグラー 010/033 同梱OK (5415)", "url": "https://auctions.yahoo.co.jp/jp/auction/q1208197079", "image": "https://auc-pctr.c.yimg.jp/i/auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/dr000/auc0111/user/b67a078f70bf6b859386ac58d02c03637a96d7bee770081eca5fb2a0351e40c4/i-img747x1051-17633739808263osby2134.jpg?pri=l&w=300&h=300&up=0&nf_src=sy&nf_path=images/auc/pc/top/image/1.0.3/na_170x170.png&nf_st=200", "price": 199, "buy_now_price": 201, "buy_now_price_excluding_tax": 201, "start_price_excluding_tax": 199, "currency": "JPY", "bid_count": 0, "watch_count": 0, "quantity": 1, "is_fixed_price": false, "listing_type": "individual", "condition": "worn", "condition_code": "USED60", "category": { "id": 2084317608, "name": "シングルカード", "path": [ { "id": 25464, "name": "おもちゃ、ゲーム" }, { "id": 27727, "name": "ゲーム" }, { "id": 25826, "name": "トレーディングカードゲーム" } ] }, "brand_id": null, "catalog_id": null, "item_location": { "code": 12, "name": "千葉県" }, "free_shipping": false, "shipping_fee": null, "shipping_fee_type": null, "shipping_fee_timing": "decided_after_sale", "buy_now_shipping_fee": null, "is_featured": false, "is_new_arrival": true, "is_appraised": false, "easy_payment": true, "start_time": "2026-09-15T13:41:26Z", "end_time": "2026-09-16T13:41:26Z", "rating": null, "review_count": null, "rating_scale": null } ], "count": 50, "total_results": 470014, "category_facets": [ { "id": 25464, "name": "おもちゃ、ゲーム", "count": 463301 }, { "id": 20060, "name": "コミック、アニメグッズ", "count": 4306 }, { "id": 20000, "name": "アンティーク、コレクション", "count": 1494 } ], "page": 1, "has_more": true, "filters": { "sort": "ending_soon", "page": 1, "limit": 50, "exclude_suspected_fakes": true, "shipping_destination": 13 }, "query": "ポケモンカード" } }
How the Yahoo! Auctions Japan API works
Yahoo! Auctions 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 252 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.
Price an item on what it SOLD for, then bid on a live auction with the real landed cost
Asking prices tell you what sellers hope for; sold auctions tell you what buyers paid. Yahoo! Auctions publishes both, and a store's price only means something with tax and shipping added.
{"query": "iphone 13", "condition": "good", "limit": 50}Up to 50 sold auctions with their tax-included sold price, plus the average, lowest and highest sold price across every match.
{"query": "iphone 13", "condition": "good", "sort": "ending_soon", "shipping_destination": 27}Live auctions ending soonest, with the current price, buy-now price and the shipping fee to Osaka on each row. Take items[].auction_id.
{"auction_id": "<an id from the search>", "shipping_destination": 27}The full auction: time left, bids, tax-included price and pre-tax figure, shipping methods and fee to Osaka, the seller's good and bad rating counts and the returns policy.
A sold-price benchmark, the live auctions against it, and the landed cost of the one you want - tax and shipping included - in three calls.
curl -X POST https://api.reefapi.com/yahoo-auctions/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"ポケモンカード","limit":20}'{
"ok": true,
"data": { … },
"meta": {
"api": "yahoo-auctions",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}Store prices on Yahoo! Auctions come in two figures - this API always gives you the one the bidder pays
A store listing on Yahoo! Auctions has a price before consumption tax and a price with tax, and the auction record carries both under names that make the pre-tax one look like the price. Read the wrong one and every store listing is about 9% too cheap while still looking like a valid number. Here price is always tax included, on search rows and on the full record alike, and the pre-tax figure and the tax rate sit beside it. Individual sellers charge no tax, so their price_excluding_tax is null.
| Auction (checked 2026-09-15) | price (tax included) | price_excluding_tax | What the auction page shows |
|---|---|---|---|
| Watch lot, store listing (Watches) | 71,500 JPY | 65,000 JPY | 71,500 円（税込） |
| iPhone 13 Pro Max 128 GB, store listing | 50,609 JPY | 46,009 JPY | 50,609 円（税込） |
| Canon EF 100mm macro lens, store listing | 6,245 JPY | 5,678 JPY | 6,245 円（税込） |
| SLOBE IENA dress, store fixed price | 2,300 JPY | 2,091 JPY | 価格 2,300 円（税込） |
| SEIKO women's watch, individual seller | 4,300 JPY | null - no tax charged | 4,300 円（税0円） |
All five were read from the public auction page moments after the API call. Across the 12 auctions verified, the price and the tax note matched the page on 12 of 12, and the price on the search row matched the full record on 12 of 12. The same rule applies to the buy-now price: a store's buy-now figure is returned tax included, with buy_now_price_excluding_tax beside it.
Which prices, which shipping fees, what the site masks, and what it leaves out
auctions.yahoo.co.jp only - one country, one currency, and no Yahoo! account of yours anywhere in the call. Measured on 2026-09-15 with 115 consecutive live calls across all seven actions, a 64-case end-to-end run and a 12-auction check against the public auction pages. Three of these lines go against us.
This API reads Yahoo! Auctions Japan (ヤフオク!). There is no country parameter because there is no other storefront. Prices are whole yen. What you send is a ReefAPI key; no Yahoo! account is involved.
Store listings have a pre-tax and a tax-included figure. price is the tax-included one on search rows and on the full record, with price_excluding_tax and tax_rate beside it for stores. Checked against the public auction page on 12 auctions across watches, fashion, cameras, phones, trading cards and golf: 12 of 12 matched.
sold/search returns completed auctions with the price they sold for and the average, lowest and highest sold price across every match - for example 797,696 sold trading-card listings behind one keyword. The oldest sale returned for a common keyword ended roughly six months before the measurement day.
Pass a prefecture number and search rows carry the fee to it where the seller has fixed one - 34 to 45 of every 50 rows across six categories with Tokyo as the destination. product/detail adds the shipping methods, who pays and the handling time.
Each published filter returned only matching rows in a live test - condition, store or individual seller, auction or fixed price, price and buy-now price ranges, free shipping, minimum bids, featured, new arrivals, prefecture, brand and category - and each sort came back in order. Orderings the site accepts but does not apply are not offered.
Yahoo! Auctions shows asterisks instead of the seller name in search results, so seller.name is null there. The seller id, rating percentage and store flag are present on every row, and product/detail and seller/listings return the name.
Yahoo!フリマ listings appear in Yahoo! Auctions search results. They are marked listing_type fleamarket and link to the flea-market site, but they are not auctions and have no auction record, so product/detail returns NOT_FOUND for them. seller_type individual,store leaves them out.
No JAN, EAN or GTIN is published (0 of 12 records). Auctions have no product reviews - the reputation is the seller's good and bad rating counts. Store listings price postage from their own tables, so their shipping fee is null rather than guessed.
What people build with Yahoo! Auctions Japan
The jobs this data is most often used for.
endpoints
credit per call
Resale and proxy-buying businesses price items from sold/search, using what auctions actually closed at and the average across every sale rather than asking prices.
Cross-border shopping services call product/detail for the tax-included price, buy-now price, time left and the shipping fee to their Japanese warehouse prefecture.
Collectors and dealers watch a keyword or category sorted by ending_soon or most_bids to catch auctions before they close.
Brand-protection teams sweep a brand or category and pull seller/listings to see a seller's whole live inventory and rating.
What Yahoo! Auctions Japan data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 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 252 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/yahoo-auctions/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"ポケモンカード","limit":20}'import requests
r = requests.post(
"https://api.reefapi.com/yahoo-auctions/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "ポケモンカード",
"limit": 20
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Yahoo! Auctions Japan.
Get a free key →Can I get what items actually sold for on Yahoo! Auctions?▾
Yes. sold/search returns sold auctions (落札相場) with the price each item sold for, tax included, the bid count, the end date, condition and seller, and price_statistics with the average, lowest and highest sold price across every matching sale, not only the page you fetched. Search by keyword, category or seller id, and narrow by condition, store or individual seller and price. On 2026-09-15 the oldest sale returned for a common keyword ended on 2026-03-19, so the history reaches back about six months.
Is the price tax included?▾
Always. Store listings have a pre-tax and a tax-included figure, and price is the tax-included one on every action. For store listings product/detail also returns price_excluding_tax and tax_rate (10). Checked against the public auction page on 12 auctions on 2026-09-15: 12 of 12 matched, including the tax note the page prints.
Does it return the shipping cost?▾
Yes, to the prefecture you choose. Pass shipping_destination as a prefecture number from 1 to 47 (13 Tokyo, 27 Osaka, 47 Okinawa); it defaults to Tokyo, as on the site. Search rows then carry shipping_fee where the seller has fixed one - 34 to 45 of every 50 rows across six categories measured - and fees change by destination. product/detail returns the shipping methods, the fee to your prefecture, who pays, the handling time and whether anonymous delivery is available. Store listings price postage from their own tables, so their fee comes back null rather than a guessed number, and listings with free shipping come back as 0.
What is the difference between price and buy_now_price?▾
price is the current bid on an auction (or the listed price on a fixed-price listing). buy_now_price is the 即決 price a buyer can pay to end the auction immediately, null when the seller did not set one. On a fixed-price listing the two are equal and is_fixed_price is true.
Why is the seller name empty on search rows?▾
Because Yahoo! Auctions masks it there. Search rows carry the seller id, the positive-rating percentage and whether it is a store; the name is null rather than the asterisks the site shows. product/detail and seller/listings return the seller's display name, and where the site masks even that, the name stays null.
Some results link to Yahoo!フリマ instead of an auction. Why?▾
Yahoo! Auctions mixes Yahoo!フリマ fixed-price flea-market listings into its search results. They come back with listing_type fleamarket and a link to the flea-market site, and they are not auctions, so product/detail returns NOT_FOUND for them with that explanation. Filter them out with seller_type individual,store. How many appear depends on the keyword: 22 of 50 rows for iphone 13, none for watches, on 2026-09-15.
Are there product reviews or ratings?▾
No - every auction is a single object, so rating, review_count and rating_scale are null rather than invented. The reputation that exists is the seller's: product/detail returns the positive percentage, the good and bad rating counts, and store, best-store, excellent-seller and identity-verified badges.
How deep can I page?▾
Up to 100 listings per call and results up to position 15,000 plus one page; deeper pages are rejected with a clear error instead of an empty answer. total_results is the site's own count, and a keyword with no results comes back ok with an empty list.
What does Yahoo! Auctions NOT publish?▾
No barcode: no JAN, EAN or GTIN on any of the 12 verified records, so gtin is null. No product reviews. No seller name on search rows. No shipping fee for store listings or for listings whose fee is decided after the sale. Bidder identities are masked by the site and are not returned; bid_count and bidder_count are.
What is the Yahoo! Auctions Japan API?▾
Yahoo! Auctions Japan API is a ReefAPI endpoint group for japan's auction marketplace: live auctions, sold prices with statistics, tax-included prices, shipping by prefecture. It returns live JSON through POST requests under /yahoo-auctions/v1.
Is the Yahoo! Auctions Japan API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Yahoo! Auctions Japan calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Yahoo! Auctions Japan login or account?▾
No login to Yahoo! Auctions 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 Yahoo! Auctions 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 Yahoo! Auctions Japan API use?▾
Yahoo! Auctions Japan actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
91 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Yahoo! Auctions 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 251 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-09-15.