Toretoku API & Scraper
The Toretoku API returns トレトク (toretoku.jp), a Japanese trading-card shop run by 株式会社山徳, 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 lists what the shop sells in one of eight game sections - Yu-Gi-Oh!, Pokémon, Magic: The Gathering, Duel Masters, One Piece, Yu-Gi-Oh! Rush Duel, Weiß Schwarz and other goods - with one row per condition rank: S (sealed), A, B, C or D, the price, the exact stock, rarity, the printed card number, language and set. Filter by card name or number, set, rank, language, price range and the SALE list, plus each game's own filters: foil and misprint for Magic, colour, card type, attribute and cost for One Piece, level and type for Weiß Schwarz, and card type for Yu-Gi-Oh!. card returns every rank of one card, including sold-out ranks with their last price, and for Yu-Gi-Oh! and Pokémon what the shop pays for it. buyback_search and buyback_card are the buying side: the price Toretoku pays for an A-rank copy, next to its own A-rank selling price. recent_orders is the shop's live order feed for a game: the 30 latest orders with time, card, rank and price, and no buyer data. sets lists every set of a game with the ids search takes. One ReefAPI key, the standard { ok, data, meta, error } envelope, no Toretoku account.
One card, up to five prices, and what the shop pays
Toretoku prices every single by condition rank. On 2026-11-08 the Pokémon promo ポンチョを着たピカチュウ (PROMO 203/XY-P) had four rank prices with stock in one of them, and the buy side quoted スカル団ごっこピカチュウ (PROMO 013/SM-P) at 842,400 yen against the shop's own 1,080,000 yen A-rank price.
| What the shop shows | field | value |
|---|---|---|
| A 198,000 円 SALE · 在庫 0 | conditions[].condition, price_jpy, on_sale, stock | "A", 198000, true, 0 |
| B 94,800 円 SALE · 在庫 6 | conditions[].condition, price_jpy, on_sale, stock | "B", 94800, true, 6 |
| 型番 PROMO 203/XY-P · レアリティ PROMO | card_number, rarity | "PROMO 203/XY-P", "PROMO" |
| 買取 842,400 円 (指定買取) | buyback_price_jpy, buyback_status | 842400, "specific" |
| まとめ買取対象 (no price) | buyback_price_jpy, buyback_status | null, "bulk_only" |
Prices include tax; card also returns the tax-excluded figure per rank. Toretoku quotes one buy price per card, for an A-rank copy, and for about half of the Pikachu cards it buys (208 of 381 on 2026-11-08) it quotes none and takes them only in a bulk parcel. Those come back with buyback_price_jpy null, never a guessed number.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/toretoku/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"game": "pokemon",
"keyword": "ピカチュウ",
"sort": "price_desc"
}
}{
"ok": true,
"meta": {
"api": "toretoku",
"endpoint": "search",
"mode": "live",
"latency_ms": 1868.5,
"record_count": 30,
"bytes": 2203581,
"cache_hit": false,
"game": "pokemon",
"page": 1,
"per_page": 30,
"last_page": 14,
"has_more": true,
"sort": "price_desc",
"filters_applied": {
"in_stock": true,
"keyword": "ピカチュウ"
},
"upstream_requests": 1,
"charged_credits": 2,
"version": "1.0.0",
"request_id": "9a90f504e8214a24",
"queue_ms": 1.4,
"fetched_at": "2026-11-08T13:04:32.631Z"
},
"data": {
"rows": [
{
"id": "63777",
"sku": "186865jct",
"product_code": "186865",
"game": "pokemon",
"name": "＿のピカチュウ LV.17 (2周年アニバーサリー)",
"rarity": "PROMO",
"card_number": "旧PROMO No.025",
"language": "japanese",
"language_label": "日本語",
"condition": "C",
"condition_label": "ランクC",
"price_jpy": 128000,
"stock": 1,
"in_stock": true,
"set": {
"id": 595,
"name": "旧裏面・プロモーションカード(旧PROMO)",
"series_id": 426,
"series": "PROMO",
"category_id": 43,
"category": "プロモーションカード"
},
"image": "https://imgw.yamatoku-api.jp/group4/itemcd/tj186865.jpg.webp",
"url": "https://www.toretoku.jp/item/details/63777",
"currency": "JPY",
"price_includes_tax": true
},
{
"id": "63157",
"sku": "185219jct",
"product_code": "185219",
"game": "pokemon",
"name": "ピカチュウ",
"rarity": "RR",
"card_number": "CP3 010/032",
"language": "japanese",
"language_label": "日本語",
"condition": "C",
"condition_label": "ランクC",
"price_jpy": 108000,
"stock": 1,
"in_stock": true,
"set": {
"id": 563,
"name": "ポケキュンコレクション(CP3)",
"series_id": 420,
"series": "XY",
"category_id": 41,
"category": "コンセプトパック"
},
"image": "https://imgw.yamatoku-api.jp/group4/itemcd/tj185219.jpg.webp",
"url": "https://www.toretoku.jp/item/details/63157",
"currency": "JPY",
"price_includes_tax": true
},
{
"id": "65987",
"sku": "185749jbt",
"product_code": "185749",
"game": "pokemon",
"name": "おきがえピカチュウ",
"rarity": "PROMO",
"card_number": "PROMO 099/XY-P",
"language": "japanese",
"language_label": "日本語",
"condition": "B",
"condition_label": "ランクB",
"price_jpy": 99800,
"stock": 1,
"in_stock": true,
"set": {
"id": 594,
"name": "プロモーションカード(PROMO)",
"series_id": 426,
"series": "PROMO",
"category_id": 43,
"category": "プロモーションカード"
},
"image": "https://imgw.yamatoku-api.jp/group4/itemcd/tj185749.jpg.webp",
"url": "https://www.toretoku.jp/item/details/65987",
"currency": "JPY",
"price_includes_tax": true
}
]
}
}What the Toretoku API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Cards and sealed products Toretoku sells in one game, one row per condition rank: price in JPY, exact stock, rarity, card number, language and set; filter by name or number, set, rank, language, price, SALE and the game's own card filters; sort by popularity, newest, price or last price change. | Pricing teams call search to get cards and sealed products Toretoku sells in one game, one row per condition rank. | game, keyword, set_id, series_id, category_id, ... |
| card | One Toretoku product in full: price, SALE flag and stock for every condition rank (sold-out ranks too), rarity, card number, language, set — and, for Yu-Gi-Oh! and Pokémon, what the shop pays for it. | Marketplace operators call card to get one Toretoku product in full. | product_id, include_buyback |
| buyback_search | What Toretoku pays (買取) for Yu-Gi-Oh! and Pokémon cards: buy price in JPY for an A-rank copy, by name, card number or set, sorted by buy price, with the shop's own total count. | Catalog enrichment teams call buyback_search to get what Toretoku pays (買取) for Yu-Gi-Oh! and Pokémon cards. | game, keyword, category_id, priced_only, sort, ... |
| buyback_card | One card on the buy-back site: the price the shop pays for an A-rank copy (or that it takes it only in a bulk parcel), its language, set and notes. | Retail analysts call buyback_card to get one card on the buy-back site. | item_code, game |
| sets | Every set Toretoku lists for one game with its series and top-level category — the ids `search` takes (side=sale) or `buyback_search` takes (side=buyback). | Pricing teams call sets to get every set Toretoku lists for one game with its series and top-level category. | game, side |
| recent_orders | Toretoku's live order feed (注文速報) for one game: the 30 latest orders with time, card, condition rank and the price paid — no buyer data. | Marketplace operators call recent_orders to get toretoku's live order feed (注文速報) for one game. | game |
| games | The games Toretoku covers, the value each action takes, and which ones have a buy-back price list. | Catalog enrichment teams call games to get the games Toretoku covers, the value each action takes, and which ones have a buy-back price…. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/toretoku/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"game":"pokemon","keyword":"ピカチュウ","sort":"price_desc"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/toretoku/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"game": "pokemon",
"keyword": "ピカチュウ",
"sort": "price_desc"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/toretoku/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"game": "pokemon",
"keyword": "ピカチュウ",
"sort": "price_desc"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.toretoku.search with {"game":"pokemon","keyword":"ピカチュウ","sort":"price_desc"}.Who uses this API and why
- Buy-sell spread on Japanese singles: the shop's A-rank selling price and its buy price on the same row
- Japan price feeds for Pokémon, Yu-Gi-Oh! and One Piece singles per condition rank, with exact stock
- Tracking what sells: a live order feed with price and condition, per game
- Arbitrage between Japanese shops (Toretoku, Card Rush, Dorasuta, Ka-nabell) on the printed card number
Questions developers ask before integrating
What do Toretoku's condition ranks mean?
S is sealed (未開封), and A to D are used copies from best to most worn, by the shop's own standards. Each search row is one rank of one card, so a card with stock in three ranks appears three times; card returns all ranks of it together, with the sold-out ones and their last price.
Which games have buy prices?
Yu-Gi-Oh! and Pokémon. Those are the only two Toretoku publishes a buy list for. The other sections have selling prices only; for those, card returns buyback null.
Why is buyback_price_jpy null for some cards?
Toretoku splits its buying into 指定買取, where it publishes a price per card, and まとめ買取, where you send a parcel and it appraises the lot. A card in the second group shows no price on the shop's page, so the API returns buyback_status bulk_only and a null price. buyback_search returns only priced cards unless you pass priced_only false.
Can I see what is actually selling?
Yes. recent_orders returns the shop's own order feed for one game: the 30 most recent orders with the time in Japan, the card, the condition rank and the price. It updates as orders come in and carries no customer data. In two runs on a Sunday the 30 Pokémon orders spanned one to two hours; a slower game such as One Piece spanned 14 to 16.
Does it include non-Japanese cards?
Yes, where the shop stocks them. Filter with language, for example english. Some older imported singles carry no language label in the shop's listing, so language is null there and the card name says 英語版 or 中国語版 instead.
What is the Toretoku API?
Toretoku API is a ReefAPI endpoint group for トレトク (toretoku.jp) card prices as json: yen price and stock per condition rank for 8 games, buy prices for yu-gi-oh! and pokémon, and the shop's live order feed. It returns live JSON through POST requests under /toretoku/v1.
Is the Toretoku API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Toretoku calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Toretoku login or account?
No login to Toretoku 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 Toretoku 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 Toretoku API use?
Toretoku actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Toretoku from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call toretoku actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Toretoku API a Toretoku scraper?
It is the managed alternative to a DIY Toretoku 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 トレトク (toretoku.jp) card prices as json: yen price and stock per condition rank for 8 games, buy prices for yu-gi-oh! and pokémon, and the shop's live order feed back as clean JSON.
Why does my Toretoku scraper keep getting blocked?
Most Toretoku 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.