{"openapi":"3.0.3","info":{"title":"BIGWEB API (ReefAPI)","version":"1.0.0","description":"BIGWEB API — Japanese trading-card shop BIGWEB / BIG MAGIC (bigweb.co.jp): selling prices per condition with stock and the shop's buy-back prices (買取価格) with how many it takes, for 29 games including Magic: The Gathering, Pokémon, Yu-Gi-Oh!, One Piece, Duel Masters and Weiß Schwarz. JPY, no login, no key. Call POST /bigweb/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.","contact":{"name":"ReefAPI","url":"https://reefapi.com/bigweb-api","email":"support@reefapi.com"},"license":{"name":"ReefAPI Terms","url":"https://reefapi.com/terms"},"termsOfService":"https://reefapi.com/terms"},"externalDocs":{"description":"BIGWEB API documentation","url":"https://reefapi.com/docs/bigweb"},"servers":[{"url":"https://api.reefapi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"bigweb","description":"BIGWEB API — Japanese trading-card shop BIGWEB / BIG MAGIC (bigweb.co.jp): selling prices per condition with stock and the shop's buy-back prices (買取価格) with how many it takes, for 29 games including Magic: The Gathering, Pokémon, Yu-Gi-Oh!, One Piece, Duel Masters and Weiß Schwarz. JPY, no login, no key."}],"paths":{"/bigweb/v1/search":{"post":{"operationId":"bigweb_search","summary":"Search BIGWEB's products for one game by card name or card number, set, rarity, colour, condition, language, the game's own extra filters, curated lists and reduced prices; sort by price, newest or sy","description":"Search BIGWEB's products for one game by card name or card number, set, rarity, colour, condition, language, the game's own extra filters, curated lists and reduced prices; sort by price, newest or syllabary. One row per card and condition, with the yen price and stock.","tags":["bigweb"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"game":{"type":"string","enum":["mtg","yugioh","pokemon","dm","union","onepiece","dbscg","bs","digimon","fftcg","gundamgcg","ultraman","vg","fe","supply","hololive","ws","wix","zx","character-supply","lorcana","eiketsu","sangokushi","lycee","rebirth","evolve","sc","godzilla","ganba"],"example":"pokemon","description":"Which game: the shop's slug (mtg, pokemon, yugioh, onepiece, dm, ws, lorcana, …). The numeric id from `games` also works. Common names such as duel_masters or one_piece are accepted."},"keyword":{"type":"string","example":"ピカチュウ","description":"Card name (Japanese; English for MTG / Lorcana) or printed card number such as 288/SM-P, QCCU-JP170 or OP10-033 — the shop's own search matches both."},"set_id":{"type":"string","example":"8533","description":"One set id, or several comma-separated (the `sets` action lists them)."},"rarity_id":{"type":"string","example":"3007","description":"Rarity id(s), comma-separated. The `filters` action lists this game's ids and names."},"color_id":{"type":"string","example":"1609","description":"Colour / element / attribute id(s), whatever this game's colour filter is (`filters`)."},"condition_id":{"type":"string","example":"620","description":"Physical condition id(s) from `filters`, in the games that sell by condition (Pokémon, MTG, Yu-Gi-Oh!, Duel Masters, Weiß Schwarz, Lorcana …)."},"language_id":{"type":"string","example":"2","description":"Printed language id(s) from `filters`; only MTG and Lorcana have them."},"attribute_id":{"type":"string","example":"684","description":"The game's first extra filter id(s), e.g. One Piece card type (LEADER / CHARACTER …), Yu-Gi-Oh! theme, Duel Masters team, Weiß Schwarz card type. `filters` names it per game."},"attribute2_id":{"type":"string","example":"876","description":"The game's second extra filter id(s), e.g. One Piece attribute (打 / 斬 / 射 …). `filters` names it."},"feature_id":{"type":"integer","minimum":1,"maximum":99999999,"example":176,"description":"Only the cards of one curated list (`features` gives the ids). With buyback_search it returns what the shop pays for that list's cards, e.g. the 【強化買取中!!】 list on the sale side."},"boxes_only":{"type":"boolean","default":false,"example":true,"description":"Only sealed boxes and sets."},"singles_only":{"type":"boolean","default":false,"example":true,"description":"Drop sealed boxes and sets from the rows of this page. Applied after the page is read; meta.removed_box_rows says how many were dropped."},"sort":{"type":"string","enum":["default","price_asc","price_desc","newest","oldest","name","shelf"],"default":"default","example":"price_asc","description":"Order of the rows. Price sorts include sold-out products whose price the shop hides; combine with in_stock when you only want prices you can buy at."},"page":{"type":"integer","minimum":1,"maximum":5000,"default":1,"example":2,"description":"Page number; each page holds 100 products (the shop's fixed size). meta.last_page says how many."},"in_stock":{"type":"boolean","default":false,"example":true,"description":"Drop sold-out products from the rows of this page, as the shop's own 在庫あり switch does. A page keeps its position in the full list, so it can return fewer than 100 rows; meta.removed_sold_out_rows says how many were dropped."},"on_sale":{"type":"boolean","default":false,"example":true,"description":"Only products at a reduced price (the shop's セール品 list); list_price_jpy holds the old price."}},"required":["game"]},"example":{"game":"pokemon","keyword":"ピカチュウ"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":3}},"/bigweb/v1/buyback_search":{"post":{"operationId":"bigweb_buyback_search","summary":"BIGWEB's web buy-back list (買取) for one game: what the shop PAYS per card and condition and how many copies it takes; the same name, number, set, rarity and condition filters as search, sorted by buy ","description":"BIGWEB's web buy-back list (買取) for one game: what the shop PAYS per card and condition and how many copies it takes; the same name, number, set, rarity and condition filters as search, sorted by buy price if you want. BIG MAGIC's walk-in stores may pay differently.","tags":["bigweb"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"game":{"type":"string","enum":["mtg","yugioh","pokemon","dm","union","onepiece","dbscg","bs","digimon","fftcg","gundamgcg","ultraman","vg","fe","supply","hololive","ws","wix","zx","character-supply","lorcana","eiketsu","sangokushi","lycee","rebirth","evolve","sc","godzilla","ganba"],"example":"pokemon","description":"Which game: the shop's slug (mtg, pokemon, yugioh, onepiece, dm, ws, lorcana, …). The numeric id from `games` also works. Common names such as duel_masters or one_piece are accepted."},"keyword":{"type":"string","example":"ピカチュウ","description":"Card name (Japanese; English for MTG / Lorcana) or printed card number such as 288/SM-P, QCCU-JP170 or OP10-033 — the shop's own search matches both."},"set_id":{"type":"string","example":"8533","description":"One set id, or several comma-separated (the `sets` action lists them)."},"rarity_id":{"type":"string","example":"3007","description":"Rarity id(s), comma-separated. The `filters` action lists this game's ids and names."},"color_id":{"type":"string","example":"1609","description":"Colour / element / attribute id(s), whatever this game's colour filter is (`filters`)."},"condition_id":{"type":"string","example":"620","description":"Physical condition id(s) from `filters`, in the games that sell by condition (Pokémon, MTG, Yu-Gi-Oh!, Duel Masters, Weiß Schwarz, Lorcana …)."},"language_id":{"type":"string","example":"2","description":"Printed language id(s) from `filters`; only MTG and Lorcana have them."},"attribute_id":{"type":"string","example":"684","description":"The game's first extra filter id(s), e.g. One Piece card type (LEADER / CHARACTER …), Yu-Gi-Oh! theme, Duel Masters team, Weiß Schwarz card type. `filters` names it per game."},"attribute2_id":{"type":"string","example":"876","description":"The game's second extra filter id(s), e.g. One Piece attribute (打 / 斬 / 射 …). `filters` names it."},"feature_id":{"type":"integer","minimum":1,"maximum":99999999,"example":176,"description":"Only the cards of one curated list (`features` gives the ids). With buyback_search it returns what the shop pays for that list's cards, e.g. the 【強化買取中!!】 list on the sale side."},"boxes_only":{"type":"boolean","default":false,"example":true,"description":"Only sealed boxes and sets."},"singles_only":{"type":"boolean","default":false,"example":true,"description":"Drop sealed boxes and sets from the rows of this page. Applied after the page is read; meta.removed_box_rows says how many were dropped."},"sort":{"type":"string","enum":["default","price_asc","price_desc","newest","oldest","name","shelf"],"default":"default","example":"price_asc","description":"Order of the rows. Price sorts include sold-out products whose price the shop hides; combine with in_stock when you only want prices you can buy at."},"page":{"type":"integer","minimum":1,"maximum":5000,"default":1,"example":2,"description":"Page number; each page holds 100 products (the shop's fixed size). meta.last_page says how many."}},"required":["game"]},"example":{"game":"mtg","keyword":"Lightning Bolt"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":3}},"/bigweb/v1/card":{"post":{"operationId":"bigweb_card","summary":"One BIGWEB product in full: sale price and stock, what the shop pays for it and how many it takes, description — plus the same card in its other conditions on both sides.","description":"One BIGWEB product in full: sale price and stock, what the shop pays for it and how many it takes, description — plus the same card in its other conditions on both sides.","tags":["bigweb"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string","example":"726157","description":"A BIGWEB product id (a row's `id`) or a bigweb.co.jp card URL (/products/<game>/cardViewer/<id>)."},"include_other_conditions":{"type":"boolean","default":true,"example":false,"description":"Also return the same card (same name, number and set) in its other conditions, on both the sale and the buy-back side. Each condition is a separate product at BIGWEB."}},"required":["product_id"]},"example":{"product_id":"726157"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/bigweb/v1/sets":{"post":{"operationId":"bigweb_sets","summary":"Every set / expansion BIGWEB lists for one game, in the shop's order, with its code — the ids `search` takes as set_id.","description":"Every set / expansion BIGWEB lists for one game, in the shop's order, with its code — the ids `search` takes as set_id.","tags":["bigweb"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"game":{"type":"string","enum":["mtg","yugioh","pokemon","dm","union","onepiece","dbscg","bs","digimon","fftcg","gundamgcg","ultraman","vg","fe","supply","hololive","ws","wix","zx","character-supply","lorcana","eiketsu","sangokushi","lycee","rebirth","evolve","sc","godzilla","ganba"],"example":"pokemon","description":"Which game: the shop's slug (mtg, pokemon, yugioh, onepiece, dm, ws, lorcana, …). The numeric id from `games` also works. Common names such as duel_masters or one_piece are accepted."}},"required":["game"]},"example":{"game":"yugioh"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/bigweb/v1/filters":{"post":{"operationId":"bigweb_filters","summary":"This game's filter vocabulary: rarities, colours, physical conditions, languages and the game's extra filters (card type, attribute, theme, team …), with the ids search takes.","description":"This game's filter vocabulary: rarities, colours, physical conditions, languages and the game's extra filters (card type, attribute, theme, team …), with the ids search takes.","tags":["bigweb"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"game":{"type":"string","enum":["mtg","yugioh","pokemon","dm","union","onepiece","dbscg","bs","digimon","fftcg","gundamgcg","ultraman","vg","fe","supply","hololive","ws","wix","zx","character-supply","lorcana","eiketsu","sangokushi","lycee","rebirth","evolve","sc","godzilla","ganba"],"example":"pokemon","description":"Which game: the shop's slug (mtg, pokemon, yugioh, onepiece, dm, ws, lorcana, …). The numeric id from `games` also works. Common names such as duel_masters or one_piece are accepted."}},"required":["game"]},"example":{"game":"pokemon"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/bigweb/v1/features":{"post":{"operationId":"bigweb_features","summary":"The shop's curated lists for one game, with their first products: pick-ups, recommended cards, the 【強化買取中!!】 list of cards it wants to buy, and on the buy-back side the sets it is buying now.","description":"The shop's curated lists for one game, with their first products: pick-ups, recommended cards, the 【強化買取中!!】 list of cards it wants to buy, and on the buy-back side the sets it is buying now.","tags":["bigweb"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"game":{"type":"string","enum":["mtg","yugioh","pokemon","dm","union","onepiece","dbscg","bs","digimon","fftcg","gundamgcg","ultraman","vg","fe","supply","hololive","ws","wix","zx","character-supply","lorcana","eiketsu","sangokushi","lycee","rebirth","evolve","sc","godzilla","ganba"],"example":"pokemon","description":"Which game: the shop's slug (mtg, pokemon, yugioh, onepiece, dm, ws, lorcana, …). The numeric id from `games` also works. Common names such as duel_masters or one_piece are accepted."},"side":{"type":"string","enum":["sale","buyback"],"default":"sale","example":"buyback","description":"Which curated lists to return."}},"required":["game"]},"example":{"game":"pokemon"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/bigweb/v1/suggest":{"post":{"operationId":"bigweb_suggest","summary":"Product names matching part of a name, grouped by product type, as in the shop's search box.","description":"Product names matching part of a name, grouped by product type, as in the shop's search box.","tags":["bigweb"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","example":"ピカチュウ","description":"Part of a name; returns the matching product names, grouped by product type."},"game":{"type":"string","enum":["mtg","yugioh","pokemon","dm","union","onepiece","dbscg","bs","digimon","fftcg","gundamgcg","ultraman","vg","fe","supply","hololive","ws","wix","zx","character-supply","lorcana","eiketsu","sangokushi","lycee","rebirth","evolve","sc","godzilla","ganba"],"example":"yugioh","description":"Optional: limit to one game."}},"required":["keyword"]},"example":{"keyword":"ピカチュウ"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/bigweb/v1/games":{"post":{"operationId":"bigweb_games","summary":"The games BIGWEB lists, with their slugs and which filters each game has.","description":"The games BIGWEB lists, with their slugs and which filters each game has.","tags":["bigweb"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Envelope":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"data":{"description":"Action result (shape varies per action)"},"meta":{"type":"object","description":"api, endpoint, mode, latency_ms, record_count, completeness_pct"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}}}}}}}}