{ "openapi": "3.0.1", "info": { "title": "Yuyu-tei 游游亭 日本卡牌 Japan TCG — Sell, Buy-back & Spread", "description": "日本卡牌代购与跨境卡商必备：一次调用即可拿到游游亭（遊々亭）日文单卡的销售价与回收价分位数、每张卡实测的买卖价差、稀有度分布、在库率与有瑕（傷有り）折价。支持宝可梦卡、游戏王、海贼王卡牌等日本卡牌。回收价是日本市场的客观地板价，TCGplayer 等海外数据源没有。不采集图片与商品说明。From $0.02 per call, no subscription.", "version": "0.1", "x-build-id": "e6cY1if0vBeHNm81X" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~yuyutei-tcg-price-cn/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-yuyutei-tcg-price-cn", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jpmarketdata~yuyutei-tcg-price-cn/runs": { "post": { "operationId": "runs-sync-jpmarketdata-yuyutei-tcg-price-cn", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jpmarketdata~yuyutei-tcg-price-cn/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-yuyutei-tcg-price-cn", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "game", "searchMode" ], "properties": { "game": { "title": "卡牌游戏代码 Game (yuyu-tei section code)", "type": "string", "description": "要查询哪种卡牌游戏。常用代码：poc = 宝可梦卡（ポケモンカードゲーム）、ygo = 游戏王（遊戯王）、opc = 海贼王、dm = 决斗大师、ws = Weiss Schwarz、ua = Union Arena、vg = Vanguard、digi = 数码宝贝、bs = Battle Spirits、gcg = 高达卡牌。店铺使用的其他代码同样可用——它就是 https://yuyu-tei.jp/sell//s/... 里的那一段路径。Which card game to search.", "default": "poc" }, "searchMode": { "title": "检索方式 Search by", "enum": [ "cardName", "setCode" ], "type": "string", "description": "cardName = 在整个卡池里按卡名搜索；setCode = 列出某个收录弹（补充包）的全部卡。cardName searches the whole game catalog for a card name, setCode lists every card of one expansion set.", "default": "cardName" }, "cardName": { "title": "卡名 Card name", "type": "string", "description": "「检索方式」选 cardName 时使用。请用日文——店铺卡池只有日文（ピカチュウ = 皮卡丘、青眼の白龍 = 青眼白龙、ルフィ = 路飞）。一次调用计费 $0.02。Used when 'Search by' is cardName; Japanese works best, the catalog is Japanese-only." }, "setCode": { "title": "收录弹代码 Set / expansion code", "type": "string", "description": "「检索方式」选 setCode 时使用，即收录弹页面 URL 里的代码，例如 https://yuyu-tei.jp/sell/poc/s/m05 中的 m05。会返回该收录弹的全部卡（单页，无分页）。Used when 'Search by' is setCode; returns every card of that set." }, "rarity": { "title": "稀有度筛选（可选）Rarity filter (optional)", "type": "string", "description": "只保留某一种稀有度，写法与店铺分区标题一致：SR、SAR、AR、RR、R、U、C、UR、CHR、PROMO……（每种游戏不同）。留空则包含全部稀有度。Keep only one rarity, as printed in the shop's section headings; leave empty for all rarities." }, "includeDamaged": { "title": "包含有瑕卡（傷有り）Include damaged copies", "type": "boolean", "description": "默认开启。会多发一次请求读取「傷有り」（有瑕）卡池，并给出有瑕卡相对同一张正常卡便宜多少（折价中位数）。关掉后每次运行只发 2 个请求而不是 3 个。On by default; adds one request that reads the damaged catalog and reports the median discount.", "default": true }, "inStockOnly": { "title": "只统计有货的卡 In-stock cards only", "type": "boolean", "description": "默认关闭：缺货的卡仍保留其挂牌价，属于行情的一部分。开启后所有统计只覆盖今天就能发货的卡。Off by default: out-of-stock cards keep their listed price and are part of the market picture.", "default": false }, "includeIndividualCards": { "title": "输出单卡明细 Include individual cards", "type": "boolean", "description": "默认关闭：一次运行固定 $0.02，只返回行情汇总。开启后还会逐张输出（卡号、卡名、稀有度、销售价、回收价、价差、有瑕价、库存、详情链接），费用 +$0.002/张。**任何情况下都不会返回图片与商品说明文**。Off by default; images and product descriptions are never returned.", "default": false }, "maxRecords": { "title": "单卡明细上限 Max individual card records", "minimum": 1, "maximum": 1000, "type": "integer", "description": "开启「输出单卡明细」时，最多输出（并计费）多少张单卡记录。无论此值为多少，行情汇总始终覆盖检索到的全部卡。Caps how many individual card records are returned and billed; the market summary always covers every card found.", "default": 100 }, "convertToUsd": { "title": "换算美元 Convert prices to USD", "type": "boolean", "description": "在日元统计旁附上美元统计，使用实时汇率（open.er-api.com），方便和 eBay、TCGplayer、CardMarket 的行情对比。Adds USD statistics next to JPY using the current exchange rate.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }