Yuyu-tei Japan TCG Singles — Sell, Buy-back & Spread in 1 Call

What does this card cost in Japan — and what will a Japanese shop pay for it? One call answers both, for a card name or a whole expansion set.

This Actor reads Yuyu-tei (遊々亭 — a major Japanese trading-card retailer), which publishes its selling price and its buy-back price on the same catalog, and returns one compact market record:

• sellPriceJpy — min / p25 / median / p75 / max / average of the Japanese retail price
• buyPriceJpy — the same quantiles for the price the shop pays to buy the card back (買取価格). This is the objective ceiling on what a card can be sourced for in Japan, and it does not exist in any TCGplayer/CardMarket-derived dataset
• spreadPct — the measured sell/buy spread per card, (sell − buy) / sell. The two sides are joined on the shop's own hidden cart keys (cart_ver / cart_cid), so it is a real per-card match, not a name join
• rarityBreakdown — count, median sell, median buy and median spread per rarity (SR / SAR / AR / RR / …)
• inStockRatio, damaged.medianDiscountPct (how much cheaper a 傷有り copy is), buyPriceUpCount (cards whose buy-back price was just raised — a demand signal), topBySellPrice and tightestSpread top-5 lists
• USD conversion at the current rate

There is no paging on this shop: a search renders its entire result set on one page (312 cards measured), so cardsFound is the exact population, not a sample.

No login, no API key, nothing stored between runs. 2–3 requests per run.

Pricing — from $0.02 per call, no subscription

Event	Price	When
Market summary	$0.02	Once per run (per query analyzed)
Individual card record	$0.002	Only if you enable Include individual cards

A default run costs $0.02 and takes about 6 seconds. A query that finds zero cards is never charged.

Input

Field	Example	Notes
game	"poc"	Section code: poc Pokemon / ygo Yu-Gi-Oh! / opc One Piece / dm Duel Masters / ws Weiss Schwarz / ua Union Arena / vg Vanguard / digi Digimon / bs Battle Spirits / gcg Gundam. Any other code the shop uses also works
searchMode	"cardName"	cardName = search the catalog, setCode = list a whole expansion
cardName	"ピカチュウ"	Japanese works best — the catalog is Japanese-only
setCode	"m05"	The code in the set URL, e.g. https://yuyu-tei.jp/sell/poc/s/m05
rarity	"SR"	Optional: keep only one rarity, as printed in the section headings
includeDamaged	true	Adds 1 request and the damaged-copy discount
inStockOnly	false	Restrict every statistic to cards that can ship today
includeIndividualCards	false	Enable to also get one record per card (+$0.002 each)
maxRecords	100	Caps the individual records only — the summary always covers every card found
convertToUsd	true	Adds USD statistics

Output example (type: "market_summary", values measured for ピカチュウ)

{
  "type": "market_summary",
  "query": "ピカチュウ",
  "game": "poc",
  "gameName": "Pokemon Card Game (ポケモンカードゲーム)",
  "searchMode": "cardName",
  "rarityFilter": null,
  "cardsFound": 312,
  "inStockCount": 133,
  "inStockRatio": 0.4263,
  "sellPriceJpy": {"min": 30, "p25": 780, "median": 9980, "p75": 79800, "max": 998000, "average": 114065},
  "buyPriceJpy": {"n": 272, "min": 2, "p25": 1100, "median": 11000, "p75": 66250, "max": 800000, "average": 85612},
  "spreadPct": {"n": 272, "p25": 39.4, "median": 39.8, "p75": 55.6},
  "damaged": {"n": 111, "medianDiscountPct": 40.3},
  "rarityBreakdown": [
    {"rarity": "PROMO", "count": 145, "sellMedian": 79800, "buyMedian": 48000, "spreadMedianPct": 39.7},
    {"rarity": "TD", "count": 66, "sellMedian": 50, "buyMedian": 100, "spreadMedianPct": 70.6},
    {"rarity": "SR", "count": 5, "sellMedian": 34800, "buyMedian": 25000, "spreadMedianPct": 39.6}
  ],
  "buyPriceUpCount": 251,
  "topBySellPrice": [
    {"cardId": "smpromo-300-10088", "cardNumber": "288/SM-P", "name": "ピカチュウ", "rarity": "PROMO",
     "sellPriceJpy": 998000, "buyPriceJpy": 800000, "spreadPct": 19.8}
  ],
  "tightestSpread": [
    {"cardId": "sm09-10101", "cardNumber": "101/095", "name": "ピカチュウ＆ゼクロムGX", "rarity": "SR",
     "sellPriceJpy": 298000, "buyPriceJpy": 240000, "spreadPct": 19.5}
  ],
  "sellPriceUsd": {"min": 0.19, "p25": 4.99, "median": 63.87, "p75": 510.72, "max": 6387.2, "average": 730.02},
  "exchangeRateJpyUsd": 0.0064,
  "checkedAt": "2026-07-26T09:00:00+00:00",
  "sourceUrls": {
    "sell": "https://yuyu-tei.jp/sell/poc/s/search?search_word=%E3%83%94%E3%82%AB%E3%83%81%E3%83%A5%E3%82%A6&kizu=0",
    "buy": "https://yuyu-tei.jp/buy/poc/s/search?search_word=%E3%83%94%E3%82%AB%E3%83%81%E3%83%A5%E3%82%A6&kizu=0",
    "damaged": "https://yuyu-tei.jp/sell/poc/s/search?search_word=%E3%83%94%E3%82%AB%E3%83%81%E3%83%A5%E3%82%A6&kizu=1"
  }
}

With includeIndividualCards: true you additionally get one record per card:

{
  "type": "card",
  "query": "m05",
  "game": "poc",
  "cardId": "m05-10118",
  "cardNumber": "118/081",
  "name": "メガダークライex",
  "rarity": "MUR",
  "sellPriceJpy": 59800,
  "buyPriceJpy": 42000,
  "spreadPct": 29.8,
  "damagedPriceJpy": 35880,
  "stockStatus": "in_stock",
  "detailUrl": "https://yuyu-tei.jp/sell/poc/card/m05/10118"
}

Use cases

• Export / arbitrage sourcing — compare the Japanese retail band against eBay, TCGplayer or CardMarket, and use buyPriceJpy as the objective floor of what the card is worth in cash inside Japan
• Buylist benchmarking — spreadPct is a real Japanese shop's gross margin per card; use it to price your own buylist
• Set-level scouting — run in setCode mode right after a release and read rarityBreakdown to see which rarity carries the set's value
• Demand monitoring — schedule the Actor and watch buyPriceUpCount and the median buy price: a shop raising its buy-back offer is the earliest public signal that a card is moving
• Condition pricing — damaged.medianDiscountPct quantifies what the Japanese market takes off for a played copy

Notes & limits

• No images and no product descriptions are collected or returned. The shop's terms reserve the copyright on its images and copy, so this Actor deliberately reads only card name, card number, rarity, prices and stock — and never the image URL. Do not expect an image field
• Prices are shop asks and shop bids, not transaction records. There is no sale history and no timestamp per card, so this is a snapshot, not a time series (schedule the Actor if you want one)
• buyPriceJpy only exists for cards the shop is currently buying; cards without an offer are counted in cardsFound but excluded from the buy and spread statistics (buyPriceJpy.n / spreadPct.n tell you how many joined). Because the two sets differ, buyPriceJpy.median can sit above sellPriceJpy.median — the shop tends not to buy the cheapest cards at all
• buyPriceUpCount is the shop's own 買取強化 marker, which it applies liberally (251 of 272 cards in the measured ピカチュウ run). Read it as a trend over scheduled runs, not as an absolute rarity signal
• The set pages ignore the damaged flag, so in setCode mode the damaged catalog is fetched through the search endpoint (vers[]=<setCode>&kizu=1); the result is the same set, damaged copies only
• The rarity comes from the shop's section headings and differs per game (SR/SAR/AR for Pokemon, PROMO, - for uncategorized …)
• Japanese-language catalog: English card names mostly do not match. Use 日本語 (ピカチュウ, 青眼の白龍, モンキー・D・ルフィ)
• Read-only and throttled (1 request / 1.5 s), 2–3 requests per run
• No personal data: this is a first-party retailer's catalog, there are no sellers and no user content

---

日本語ガイド

遊々亭(yuyu-tei.jp)の日本語TCGシングルについて、販売価格・買取価格・その差(スプレッド)を1コールで返す Actor です。

• 概要: カード名または収録弾コードを指定すると、販売価格の分位点(最安・p25・中央値・p75・最高値・平均)、買取価格の分位点、そしてカード単位で実測したスプレッド((販売−買取)/販売)を返します。販売ページと買取ページはショップ自身の隠しフィールド(cart_ver/cart_cid)で突き合わせているため、カード名の文字列一致ではなく同一カードの実測差です。あわせてレアリティ別内訳(件数・販売中央値・買取中央値・スプレッド中央値)、在庫あり率、傷有り品の値引き率(中央値)、買取強化(priceup)件数、高額 Top5、スプレッド最小 Top5、USD換算を返します。
• ページングが無いため、検索結果は1ページに全件描画されます(実測312件)。cardsFound はサンプル数ではなく母集団の実数です。
• 使い方: game にセクションコード(poc=ポケカ / ygo=遊戯王 / opc=ワンピース / dm=デュエマ / ws=ヴァイス / ua=ユニアリ / vg=ヴァンガード / digi=デジモン / bs=バトスピ / gcg=ガンダム、その他のコードも可)、searchMode に cardName(カード名検索)か setCode(収録弾の全カード)を指定します。rarity でレアリティを1種類に絞れます。includeDamaged(既定 ON)は傷有りカタログを +1 リクエストで読み、inStockOnly を ON にすると在庫のあるカードだけで統計を取ります。
• 料金: マーケットサマリー1件 $0.02、個別カードレコードは $0.002/件(既定 OFF なので既定実行は $0.02 固定)。0件のクエリには課金されません。 サブスクリプション不要です。
• 画像と商品説明文は一切収集・返却しません。 遊々亭の利用規約は画像・文章の無断転載を禁じているため、本 Actor が返すのはカード名・型番・レアリティ・価格・在庫という事実データと集計統計のみです(画像URLも返しません)。
• その他の注意: 価格は「店頭掲示の販売価格/買取価格」であり成約履歴ではありません(販売日時は取得できず時系列分析は不可 — 継続監視はスケジュール実行で行ってください)。買取対象外のカードは cardsFound には含まれますが買取・スプレッド統計からは除外されます(buyPriceJpy.n / spreadPct.n で結合件数が分かります)。収録弾ページは傷有りフラグを無視するため、setCode モードの傷有りは検索エンドポイント(vers[]=<収録弾>&kizu=1)経由で取得しています。カタログは日本語のため、キーワードは日本語でご指定ください。