BIGWEB API & Scraper: parameters and responses
This is the reference for the 8 BIGWEB endpoints under /bigweb/v1 (search, buyback_search, card, sets, filters, features, suggest and games) and their 19 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.
The BIGWEB API returns bigweb.co.jp, the online shop of the Japanese card retailer BIG MAGIC, as clean JSON in yen across the 29 games it stocks, from Magic: The Gathering (279,034 products on 2026-11-08) and Weiß Schwarz (70,069) to Yu-Gi-Oh! (50,787), Duel Masters (35,995), Pokémon (35,512) and One Piece (5,289).
🤖 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.
BIGWEB sells each card in each condition as a separate product, so search returns one row per card and condition with its price, stock and points; filter by name or printed card number, set, rarity, colour, physical condition, printed language (MTG and Lorcana), the game's own filters such as One Piece card type or Yu-Gi-Oh! theme, reduced prices or the shop's curated lists, and sort by price, newest or syllabary. buyback_search returns the other side of the counter: what the shop pays per card and condition (109,627 MTG products, 15,094 Duel Masters, 13,616 Yu-Gi-Oh!, 4,196 Pokémon) and the most copies it will take. card joins both sides for one product and adds the same card in its other conditions. sets, filters, features, suggest and games list the ids the filters take. No account, no browser: one ReefAPI key and the standard { ok, data, meta, error } envelope.
One Lightning Bolt, four products: what BIGWEB sells each for and what it pays
BIGWEB lists each condition and finish as its own product. Measured on Lightning Bolt 105 (Japanese, Strixhaven Mystical Archive), 2026-11-08:
| what the shop lists | field | value |
|---|---|---|
| ニアミント: 2,500円, 在庫2 | price_jpy / stock | 2500 / 2 |
| プレイド: 2,000円, 在庫1 | condition_code / price_jpy | PLD / 2000 |
| FOILニアミント: 15,000円, 在庫1 | is_foil / price_jpy | true / 15000 |
| ニアミントを買い取ります: 1,500円, 上限8枚 | buyback_price_jpy / buy_limit | 1500 / 8 |
| FOILニアミント買取: 7,000円, 上限4枚 | other_conditions[].buyback_price_jpy | 7000 |
| 売り切れの特殊FOIL: 2,000円, 買取 1,000円 | in_stock / buyback_price_jpy | false / 1000 |
A sold-out product usually shows no price at BIGWEB, and price_jpy is then null rather than an old number; some games and sealed products keep the price visible, and it is returned as printed, with in_stock false. Buy-back prices are the web prices; BIG MAGIC's walk-in stores can pay differently, and the shop states that cards bought at 50 yen or less may pay 0 if not near mint.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/bigweb/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"game": "pokemon",
"keyword": "ピカチュウ"
}
}{
"ok": true,
"meta": {
"api": "bigweb",
"endpoint": "search",
"mode": "live",
"latency_ms": 1744.2,
"record_count": 100,
"bytes": 327316,
"cache_hit": false,
"game": "pokemon",
"total": 498,
"page": 1,
"per_page": 100,
"last_page": 5,
"has_more": true,
"sort": "default",
"filters_applied": {
"keyword": "ピカチュウ"
},
"upstream_requests": 1,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "327392bcf83e4a9d",
"queue_ms": 1.5,
"fetched_at": "2026-11-08T13:04:18.221Z"
},
"data": {
"rows": [
{
"id": 3375999,
"game": "pokemon",
"game_name": "ポケモンカードゲーム",
"name": "ポケモンカードゲーム スカーレット＆バイオレット スタートデッキGenerations ピカチュウex・カビゴンex",
"name_ja": null,
"name_kana": null,
"card_number": null,
"set": {
"id": 8218,
"name": "【SVM】スタートデッキGenerations",
"code": "SVM",
"preorder": null
},
"rarity": null,
"condition": null,
"condition_id": null,
"condition_code": null,
"is_foil": null,
"language": null,
"language_code": null,
"attributes": null,
"graded": false,
"grader": null,
"grade": null,
"variant": null,
"regulation_mark": null,
"note": null,
"displayed_at_store": null,
"is_box": true,
"is_supply": false,
"image": "https://image.bigweb.co.jp/new/imgc/033/759/3375999.jpg",
"currency": "JPY",
"price_jpy": 700,
"list_price_jpy": 850,
"on_sale": true,
"points": 8,
"stock": 0,
"in_stock": false,
"is_preorder": false,
"url": "https://www.bigweb.co.jp/ja/products/pokemon/cardViewer/3375999",
"buyback_url": "https://www.bigweb.co.jp/ja/purchase/pokemon/cardViewer/3375999"
},
{
"id": 3278423,
"game": "pokemon",
"game_name": "ポケモンカードゲーム",
"name": "ポケモンカードゲーム スカーレット＆バイオレット スターターセットex ピカチュウスペシャルセット",
"name_ja": null,
"name_kana": null,
"card_number": null,
"set": {
"id": 7642,
"name": "【SVC】スターターセットex ピカチュウex & パーモット",
"code": "SVC",
"preorder": null
},
"rarity": null,
"condition": null,
"condition_id": null,
"condition_code": null,
"is_foil": null,
"language": null,
"language_code": null,
"attributes": null,
"graded": false,
"grader": null,
"grade": null,
"variant": null,
"regulation_mark": null,
"note": null,
"displayed_at_store": null,
"is_box": true,
"is_supply": false,
"image": "https://image.bigweb.co.jp/new/imgc/032/784/3278423.jpg",
"currency": "JPY",
"price_jpy": 3580,
"list_price_jpy": null,
"on_sale": false,
"points": 35,
"stock": 0,
"in_stock": false,
"is_preorder": false,
"url": "https://www.bigweb.co.jp/ja/products/pokemon/cardViewer/3278423",
"buyback_url": "https://www.bigweb.co.jp/ja/purchase/pokemon/cardViewer/3278423"
},
{
"id": 3278422,
"game": "pokemon",
"game_name": "ポケモンカードゲーム",
"name": "ポケモンカードゲーム スカーレット＆バイオレット スターターセットex ピカチュウex＆パーモット",
"name_ja": null,
"name_kana": null,
"card_number": null,
"set": {
"id": 7642,
"name": "【SVC】スターターセットex ピカチュウex & パーモット",
"code": "SVC",
"preorder": null
},
"rarity": null,
"condition": null,
"condition_id": null,
"condition_code": null,
"is_foil": null,
"language": null,
"language_code": null,
"attributes": null,
"graded": false,
"grader": null,
"grade": null,
"variant": "※キャンセル不可",
"regulation_mark": null,
"note": "※キャンセル不可",
"displayed_at_store": null,
"is_box": true,
"is_supply": false,
"image": "https://image.bigweb.co.jp/new/imgc/032/784/3278422.jpg",
"currency": "JPY",
"price_jpy": 1800,
"list_price_jpy": 1800,
"on_sale": true,
"points": 18,
"stock": 0,
"in_stock": false,
"is_preorder": false,
"url": "https://www.bigweb.co.jp/ja/products/pokemon/cardViewer/3278422",
"buyback_url": "https://www.bigweb.co.jp/ja/purchase/pokemon/cardViewer/3278422"
}
]
}
}What the BIGWEB API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | 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. | Pricing teams call search to search BIGWEB's products for one game by card name or card number, set, rarity, colour, condi…. | game, keyword, set_id, rarity_id, color_id, ... |
| buyback_search | 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. | Marketplace operators call buyback_search to get bIGWEB's web buy-back list (買取) for one game. | game, keyword, set_id, rarity_id, color_id, ... |
| card | 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. | Catalog enrichment teams call card to get one BIGWEB product in full. | product_id, include_other_conditions |
| sets | Every set / expansion BIGWEB lists for one game, in the shop's order, with its code — the ids `search` takes as set_id. | Retail analysts call sets to get every set / expansion BIGWEB lists for one game, in the shop's order, with its code. | game |
| filters | 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. | Pricing teams call filters to get this game's filter vocabulary. | game |
| features | 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. | Marketplace operators call features to get the shop's curated lists for one game, with their first products. | game, side |
| suggest | Product names matching part of a name, grouped by product type, as in the shop's search box. | Catalog enrichment teams call suggest to get product names matching part of a name, grouped by product type, as in the shop's search box.. | keyword, game |
| games | The games BIGWEB lists, with their slugs and which filters each game has. | Retail analysts call games to get the games BIGWEB lists, with their slugs and which filters each game has.. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/bigweb/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"game":"pokemon","keyword":"ピカチュウ"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/bigweb/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"game": "pokemon",
"keyword": "ピカチュウ"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/bigweb/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"game": "pokemon",
"keyword": "ピカチュウ"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.bigweb.search with {"game":"pokemon","keyword":"ピカチュウ"}.Who uses this API and why
- Japan-to-abroad arbitrage: BIGWEB's yen price per condition next to TCGplayer, Cardmarket or eBay for the same card number
- Buy-back spread: what the shop sells a card for against what it pays, with card, on one product
- MTG price tracking for Japanese-language and foil printings across 279,000 products
- Restock watches on sold-out cards
- Spotting cards the shop is pushing to buy: its 【強化買取中!!】 list, and what it pays for each of them
Questions developers ask before integrating
Which games does BIGWEB cover?
29 games with products on 2026-11-08, including Magic: The Gathering, Weiß Schwarz, Yu-Gi-Oh!, Duel Masters, Pokémon, Cardfight!! Vanguard, Z/X, WIXOSS, Battle Spirits, Union Arena, One Piece, Digimon, Lorcana and hololive, plus card supplies. games returns the list and which filters each one has.
Why does the same card appear on several rows?
Because BIGWEB sells each condition and finish as its own product with its own price and stock: near mint, played, foil and so on. Group rows by card_number and set, or call card on any one of them to get the others in other_conditions.
Does it give the buy-back (買取) price?
Yes. buyback_search lists what the shop pays and buy_limit, the most copies it takes, and card returns the sale and buy-back sides together. On 2026-11-08 BIGWEB paid 1,200,000 yen for the Pokémon promo ピカチュウ 288/SM-P, which was itself sold out. Not every game has a web buy-back list; those return NOT_FOUND at no charge.
Are the conditions the same for every game?
No, and the API keeps them straight. MTG uses ニアミント, プレイド, ヘビー and foil versions (condition_code NM, PLD, HP, is_foil true); Pokémon uses プレイ用, 特価[傷含む], コレクター向け; One Piece and several others are sold in one condition and condition is null. A game's other filters arrive named by what they are, for example attributes.card_type LEADER on One Piece. The filters action lists the options for each game.
Can I search by card number?
Yes. keyword matches names and printed numbers, for example 288/SM-P, QCCU-JP170 or OP10-033, and every row carries card_number where the shop publishes one. Some rows have none, such as many MTG promos.
Can I get only what is in stock?
Yes. in_stock drops sold-out products from each page, and meta.removed_sold_out_rows says how many were removed, so a page can return fewer than 100 rows. Each page keeps its place in the shop's full list, so read on with page until has_more is false.
What is the BIGWEB API?
BIGWEB API is a ReefAPI endpoint group for bigweb (big magic) as json: japanese prices for 29 card games in yen, per card and condition, with stock and the shop's buy-back prices. It returns live JSON through POST requests under /bigweb/v1.
Is the BIGWEB API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. BIGWEB calls use the same shared credit balance as every other ReefAPI engine.
Do I need a BIGWEB login or account?
No login to BIGWEB 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 BIGWEB 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 BIGWEB API use?
BIGWEB actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call BIGWEB from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call bigweb actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the BIGWEB API a BIGWEB scraper?
It is the managed alternative to a DIY BIGWEB 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 bigweb (big magic) as json: japanese prices for 29 card games in yen, per card and condition, with stock and the shop's buy-back prices back as clean JSON.
Why does my BIGWEB scraper keep getting blocked?
Most BIGWEB 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.