Suruga-ya API & Scraper
The Suruga-ya API returns suruga-ya.jp, one of Japan's largest second-hand shops, as clean JSON in yen.
🤖 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.
search finds items by keyword, by trading-card game (Pokémon, Yu-Gi-Oh!, One Piece, Duel Masters, Magic: The Gathering, Weiß Schwarz, Vanguard, Digimon, Shadowverse: Evolve and more) or by department (Switch and PlayStation games, figures, comics, video, music), with filters for single cards or sealed boxes, new or used, price band, rarity, set, maker and release year, and six sort orders. Each row carries Suruga-ya's own new and used price, the price range when several conditions are on sale, time sales with their end time, the list price, whether Suruga-ya has it in stock, the cheapest marketplace shop's price and how many shops list it. product returns one item with every condition on sale and its stock count, the other conditions and graded copies (for example a PSA 10 slab) with their prices, the JAN barcode, model number, release date, category and the buy price Suruga-ya publishes. offers lists the marketplace shops selling the item: price, condition note, stock, shipping time, free shipping and the shop's rating. buyback_search and buyback return what Suruga-ya pays to buy an item (買取価格), searchable by name, JAN or model number. categories lists every card game and department id. No account, no browser - one ReefAPI key and the standard { ok, data, meta, error } envelope.
One card, five prices: what a Suruga-ya item looks like as data
Suruga-ya sells one card in several conditions, lets other shops list it beside its own stock, and publishes what it pays to buy it back. Measured on One Piece OP05-060 Monkey D. Luffy (parallel leader), 2026-11-08:
| what the site shows | field | value |
|---|---|---|
| 中古 4,780円 (2 in stock) | variants[0].price_jpy / stock_qty | 4780 / 2 |
| その他の状態: 中古 【PSA/GEM MT 10】 16,800円 | other_conditions[].price_jpy, grader, grade | 16800, PSA, 10 |
| その他の状態: 中古 Bランク 2,870円 | other_conditions[].condition_label, price_jpy | 中古 Bランク, 2870 |
| 他のショップ (14) 2,440円～ | marketplace_count / marketplace_min_price_jpy | 14 / 2440 |
| 買取価格 2,800円 | buy_price_jpy | 2800 |
Prices are yen including consumption tax. The buy price is returned only when Suruga-ya prints it: for many single cards the site quotes it by e-mail, and buy_price_jpy is then null (quote_by_email true on the buy-back actions) rather than a guess.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/surugaya/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "ピカチュウ",
"game": "pokemon",
"card_type": "single"
}
}{
"ok": true,
"meta": {
"api": "surugaya",
"endpoint": "search",
"mode": "live",
"latency_ms": 9061.3,
"record_count": 24,
"bytes": 340786,
"cache_hit": false,
"total": 360,
"page": 1,
"per_page": 24,
"last_page": 15,
"filters_applied": {
"query": "ピカチュウ",
"category": {
"id": "501080033",
"label": "ポケモンカードゲーム",
"from": "game:pokemon"
},
"card_type": "single"
},
"has_more": true,
"sort": "relevance",
"facets": {
"condition": [
{
"value": "中古",
"label": "中古",
"count": "360"
}
],
"card_type": [
{
"value": "シングル",
"label": "ON",
"count": null
}
],
"series": [
{
"value": "プロモーションカード",
"label": "プロモーションカード",
"count": "107"
},
{
"value": "SV ハイクラスパック テラスタルフェスex",
"label": "SV ハイクラスパック テラスタルフェスex",
"count": "1"
},
{
"value": "SV スタートデッキGenerations",
"label": "SV スタートデッキGenerations",
"count": "14"
}
],
"rarity": [
{
"value": "P",
"label": "P",
"count": "111"
},
{
"value": "C",
"label": "C",
"count": "32"
},
{
"value": "RR",
"label": "RR",
"count": "15"
}
],
"brand": [
{
"value": "ポケモン",
"label": "ポケモン",
"count": "360"
}
],
"year_range": [
{
"value": "[2026,*]",
"label": "2026以降",
"count": "39"
},
{
"value": "[2024,2025]",
"label": "2024 - 2025",
"count": "42"
},
{
"value": "[2023,2023]",
"label": "2023",
"count": "59"
}
],
"price": [
{
"value": "[0,699]",
"label": "￥699以下",
"count": "156"
},
{
"value": "[700,1499]",
"label": "￥700 - ￥1499",
"count": "34"
},
{
"value": "[1500,3099]",
"label": "￥1500 - ￥3099",
"count": "20"
}
],
"badge": [
{
"value": "人気上昇中",
"label": "人気上昇中",
"count": "1"
},
{
"value": "値下げ",
"label": "値下げ",
"count": "6"
},
{
"value": "新入荷",
"label": "新入荷",
"count": "223"
}
],
"discount_rate": [
{
"value": "[101,*]",
"label": "101以上",
"count": "2"
}
]
},
"currency": "JPY",
"upstream_requests": 1,
"warnings": [],
"charged_credits": 3,
"version": "1.0.0",
"request_id": "0c1cad3b99634dab",
"queue_ms": 1.6,
"fetched_at": "2026-11-08T13:04:38.537Z"
},
"data": {
"rows": [
{
"id": "GU879980",
"url": "https://www.suruga-ya.jp/product/detail/GU879980",
"name": "127/103[SAR]：(キラ)ピカチュウex",
"category_label": "ポケモンカードゲーム/SAR/雷/MEGA 拡張パック 30th CELEBRATION",
"maker": "ポケモン",
"release_date": "2026-09-16",
"release_date_raw": "2026/09/16",
"price_jpy": null,
"new_price_jpy": null,
"used_price_jpy": null,
"prices": [],
"list_price_jpy": null,
"in_stock": false,
"time_sale": null,
"other_conditions": [],
"marketplace_min_price_jpy": 5680,
"marketplace_count": 14,
"marketplace_kinds": "中古品",
"badges": [
"新入荷"
],
"listing_branch_number": null,
"listing_shop_id": null,
"image": "https://www.suruga-ya.jp/database/photo.php?shinaban=GU879980&size=m",
"price_includes_tax": true,
"currency": "JPY"
},
{
"id": "GU880048",
"url": "https://www.suruga-ya.jp/product/detail/GU880048",
"name": "034/103(18/30)：(キラ)ピカチュウ",
"category_label": "ポケモンカードゲーム/雷/MEGA 拡張パック 30th CELEBRATION",
"maker": "ポケモン",
"release_date": "2026-09-16",
"release_date_raw": "2026/09/16",
"price_jpy": 280,
"new_price_jpy": null,
"used_price_jpy": 280,
"prices": [
{
"condition": "[trimmed-depth]",
"condition_label": "[trimmed-depth]",
"price_jpy": "[trimmed-depth]",
"price_max_jpy": "[trimmed-depth]",
"regular_price_jpy": "[trimmed-depth]",
"on_sale": "[trimmed-depth]"
}
],
"list_price_jpy": null,
"in_stock": true,
"time_sale": null,
"other_conditions": [],
"marketplace_min_price_jpy": 140,
"marketplace_count": 20,
"marketplace_kinds": "中古品",
"badges": [
"新入荷"
],
"listing_branch_number": null,
"listing_shop_id": null,
"image": "https://www.suruga-ya.jp/database/photo.php?shinaban=GU880048&size=m",
"price_includes_tax": true,
"currency": "JPY"
},
{
"id": "GU880044",
"url": "https://www.suruga-ya.jp/product/detail/GU880044",
"name": "030/103(14/30)：(キラ)ピカチュウ",
"category_label": "ポケモンカードゲーム/雷/MEGA 拡張パック 30th CELEBRATION",
"maker": "ポケモン",
"release_date": "2026-09-16",
"release_date_raw": "2026/09/16",
"price_jpy": null,
"new_price_jpy": null,
"used_price_jpy": null,
"prices": [],
"list_price_jpy": null,
"in_stock": false,
"time_sale": null,
"other_conditions": [],
"marketplace_min_price_jpy": 150,
"marketplace_count": 7,
"marketplace_kinds": "中古品",
"badges": [
"新入荷"
],
"listing_branch_number": null,
"listing_shop_id": null,
"image": "https://www.suruga-ya.jp/database/photo.php?shinaban=GU880044&size=m",
"price_includes_tax": true,
"currency": "JPY"
}
]
}
}What the Suruga-ya API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Suruga-ya's catalogue: cards by game, set, rarity and single/box, or any department (games, figures, books, media …). Each row is one item with Suruga-ya's own new / used price, stock, time sale, the cheapest marketplace offer and the release date. | Pricing teams call search to search Suruga-ya's catalogue. | query, game, category, card_type, condition, ... |
| product | One Suruga-ya item in full: every sale variant (new / used / grade) with its price and stock count, the other conditions and PSA-graded copies with their prices, the cheapest marketplace offer, the buy price Suruga-ya publishes (買取価格), JAN barcode, model number, list price, maker, release date, category path, description and images. | Marketplace operators call product to get one Suruga-ya item in full. | product_id, branch_number |
| offers | The marketplace (マケプレ) offers for one item: each Suruga-ya branch store and partner shop that lists it, with price, condition note, stock, shipping time, free shipping and the shop's rating. | Catalog enrichment teams call offers to get the marketplace (マケプレ) offers for one item. | product_id, condition, sort, page |
| buyback_search | Suruga-ya's buy-back price list (買取): what Suruga-ya PAYS for an item, searched by name, JAN / ISBN barcode or model number. A BUY price — never the sale price. | Retail analysts call buyback_search to get suruga-ya's buy-back price list (買取). | query, search_by, game, category, sort, ... |
| buyback | One item's buy-back page: the buy price (買取価格), JAN, model number, list price, maker, release date and category. | Pricing teams call buyback to get one item's buy-back page. | product_id |
| categories | Suruga-ya's category ids: every trading-card game (TCG, arcade cards, collection cards, supplies — 150+) and the site's departments with their sub-categories. Give an id to search as `game` or `category`. | Marketplace operators call categories to get suruga-ya's category ids. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/surugaya/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"ピカチュウ","game":"pokemon","card_type":"single"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/surugaya/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "ピカチュウ",
"game": "pokemon",
"card_type": "single"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/surugaya/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "ピカチュウ",
"game": "pokemon",
"card_type": "single"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.surugaya.search with {"query":"ピカチュウ","game":"pokemon","card_type":"single"}.Who uses this API and why
- Japan-to-abroad card arbitrage: Suruga-ya's yen price next to snkrdunk, Card Rush, eBay or TCGplayer for the same card number
- Buy-back spread: what Suruga-ya pays (買取) against what it sells the same item for
- Graded card pricing: PSA 10 copy versus the raw card, in one call
- Retro game and figure price tracking by JAN barcode
- Restock and time-sale alerts on watched items
Questions developers ask before integrating
Does it give the buy-back (買取) price as well as the selling price?
Yes. product carries buy_price_jpy when the item page prints a 買取価格, and buyback_search and buyback return it directly, searchable by name, JAN / ISBN barcode or model number. On 2026-11-08 the buy prices of six Switch 2 games matched their own buy-back pages exactly. Many single cards are quoted by e-mail only; those come back with quote_by_email true and no price.
How do I get the price of a PSA 10 or a lower-condition copy?
product lists every condition on sale with its price and stock (variants), and the other conditions and graded copies as other_conditions with their price and branch_number; graded copies are split into grader, grade and grade_label (PSA, 10, GEM MT). Call product again with that branch_number to read its stock. Some graded slabs are also listed as items of their own, with the grade in the name.
Which card games are covered?
Every card category on Suruga-ya: game takes pokemon, pokemon_old_back, yugioh, yugioh_rush_duel, onepiece, duel_masters, mtg, weiss_schwarz, vanguard, digimon, shadowverse_evolve, battle_spirits, wixoss, zx, dragon_ball_heroes, rebirth_for_you, buddyfight and force_of_will, and categories returns all 167 card categories (TCGs, arcade cards, collection cards, supplies) with ids any search accepts.
Can I filter by rarity or set?
Yes, with the values Suruga-ya indexes, which every search returns in meta.facets (rarity, series, maker, year range, price bands, with approximate counts). Pokémon rarities such as SAR and AR are not indexed by the site; put them in the query instead ('ピカチュウ SAR' found five SAR Pikachu cards).
What are the marketplace offers?
Besides its own stock, Suruga-ya lets its branch stores and partner shops list the same item (マケプレ). offers returns each shop's price, condition note, stock, shipping days, free shipping and rating, 20 a page, cheapest first or by price high to low or by most reviews. Suruga-ya's own stock can appear in that list too and is flagged is_surugaya.
Why does a search row have no price of its own?
Suruga-ya's own stock is sold out (in_stock false); the row still shows the cheapest marketplace price. By default the list holds items someone can sell now; include_sold_out adds items nobody has (Weiß Schwarz: 51,580 items by default, 81,005 with sold-out ones).
What is the Suruga-ya API?
Suruga-ya API is a ReefAPI endpoint group for suruga-ya (駿河屋) as json: japan's big second-hand shop's sale prices for cards, games and figures, every condition and psa copy, marketplace offers and buy-back prices, in jpy. It returns live JSON through POST requests under /surugaya/v1.
Is the Suruga-ya API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Suruga-ya calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Suruga-ya login or account?
No login to Suruga-ya 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 Suruga-ya 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 Suruga-ya API use?
Suruga-ya 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 Suruga-ya from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call surugaya actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Suruga-ya API a Suruga-ya scraper?
It is the managed alternative to a DIY Suruga-ya scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same suruga-ya (駿河屋) as json: japan's big second-hand shop's sale prices for cards, games and figures, every condition and psa copy, marketplace offers and buy-back prices, in jpy back as clean JSON.
Why does my Suruga-ya scraper keep getting blocked?
Most Suruga-ya scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.