LigaOnePiece API & Scraper: parameters and responses
This is the reference for the 6 LigaOnePiece endpoints under /ligaonepiece/v1 (search, card, buylist, editions, movers and store) and their 22 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 LigaOnePiece API returns Brazil's One Piece Card Game marketplace as clean JSON in BRL: the lowest, average and highest price of each print per finish, every store's offer with stock, condition and language, store buylists, all 91 editions, sealed starter decks and the cards moving most in price.
🤖 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.
Same card, same minimum, very different ceiling: finish matters
Ace & Sabo & Luffy from Carrying On His Will (OP13-007) has a Foil and a Normal line in the guide. Their minimums are 4 cents apart, but the Foil average is R$ 32.52 and its maximum R$ 89.99, while the Normal line stays at R$ 13.19. The price guide keeps them apart, so you can compare like with like.
| Ace & Sabo & Luffy (OP13-007) | min BRL | avg BRL | max BRL |
|---|---|---|---|
| Normal | 13.19 | 13.19 | 13.19 |
| Foil | 13.15 | 32.52 | 89.99 |
Asking prices at the moment of the call on 2026-11-08, without shipping. The print had 35 offers from 19 stores; the best store buylist price was R$ 7.89.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/ligaonepiece/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "Luffy"
}
}{
"ok": true,
"meta": {
"api": "ligaonepiece",
"endpoint": "search",
"mode": "live",
"latency_ms": 3618.8,
"record_count": 40,
"bytes": 195534,
"cache_hit": false,
"requests": 2,
"rotations": 1,
"charged_credits": 3,
"version": "0.1.0",
"request_id": "3ff6b562df384b10",
"queue_ms": 1.1,
"fetched_at": "2026-11-08T13:04:27.436Z"
},
"data": {
"game": "onepiece",
"site": "LigaOnePiece",
"query": "Luffy",
"edition": null,
"sort": "relevance",
"page": 1,
"results": [
{
"type": "product",
"name": "(ING) Deck Inicial - ST-18 - PURPLE Monkey.D.Luffy",
"name_alt": null,
"product_id": 132483,
"card_id": null,
"card": null,
"edition_code": null,
"number": null,
"collector_number": null,
"edition_id": null,
"edition_name": null,
"price_min_brl": 999.9,
"price_avg_brl": 999.9,
"price_max_brl": 999.9,
"image_url": "https://repositorio.sbrauble.com/arquivos/up/prod/20241113/1731527696_2912.jpg",
"url": "https://www.ligaonepiece.com.br/?view=prod/view&pcode=132483&prod=%28ING%29+Starter+Deck+-+ST-18+-+PURPLE+Monkey.D.Luffy"
},
{
"type": "product",
"name": "(ING) Deck Inicial - ST-26 - PURPLE/BLACK Monkey.D.Luffy",
"name_alt": null,
"product_id": 133436,
"card_id": null,
"card": null,
"edition_code": null,
"number": null,
"collector_number": null,
"edition_id": null,
"edition_name": null,
"price_min_brl": 280,
"price_avg_brl": 297.13,
"price_max_brl": 300,
"image_url": "https://repositorio.sbrauble.com/arquivos/up/prod/20250506/1746548641_5873.jpg",
"url": "https://www.ligaonepiece.com.br/?view=prod/view&pcode=133436&prod=%28ING%29+Starter+Deck+EX+-+ST-26+-+PURPLE%2FBLACK+Monkey.D.Luffy"
},
{
"type": "product",
"name": "(ING) Deck Inicial - ST-31 - RED Monkey.D.Luffy",
"name_alt": null,
"product_id": 136935,
"card_id": null,
"card": null,
"edition_code": null,
"number": null,
"collector_number": null,
"edition_id": null,
"edition_name": null,
"price_min_brl": 94.2,
"price_avg_brl": 120.13,
"price_max_brl": 152,
"image_url": "https://repositorio.sbrauble.com/arquivos/up/prod/20260720/1784548882_7753.jpg",
"url": "https://www.ligaonepiece.com.br/?view=prod/view&pcode=136935&prod=%28ING%29+Starter+Deck+-+ST-31+-+RED+Monkey.D.Luffy"
}
],
"count": 40,
"has_more": true
}
}What the LigaOnePiece API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search LigaOnePiece's catalog by card or product name, or list one edition's cards: each row has the card name (Portuguese and English where the site has both), edition, collector number, the minimum, average and maximum price in BRL across Brazilian stores, the image and the keys `card`/`edition_code`/`number` that the card action takes. Sealed products appear as type=product. 40 rows a page; sort by name or by min/avg/max price. | Pricing teams call search to search LigaOnePiece's catalog by card or product name, or list one edition's cards. | query, edition, sort, page, limit |
| card | One card in full: Portuguese and English name, card details as the site lists them (rarity, type, artist, formats…), every printing with its edition, number, rarity, artist, release date, image and the price guide per finish (Normal, Foil, Foil Etched, Promo… min/avg/max BRL); then EVERY store offer — price in BRL (and the pre-discount price), copies in stock, condition, language, finish/extras, photo, graded, pre-order — with the store's name, city, state, rating, review volume, verified/physical flags and shipping time; the open auctions (current bid, buy-now, bids, end time); and the stores. | Marketplace operators call card to get one card in full. | card, url, edition, number, offers_limit, ... |
| buylist | What Brazilian stores PAY for a card (the site's Buylist tab): per store and printing, the buy price for Mint/Near Mint in Portuguese or English, the base price, the discount and resulting buy price for every accepted condition, the discount for every accepted language, and the store's city, state and rating. Use it with `card` offers for arbitrage (buy below the best buylist). | Catalog enrichment teams call buylist to get what Brazilian stores PAY for a card (the site's Buylist tab). | card, url, edition, number, limit |
| editions | Every edition (set) on LigaOnePiece: id, code, name (English and Portuguese where the site has one), release date, symbol, and whether it is a main or auxiliary (promo / grouped) edition. The id feeds search's `edition` to list the set's cards with prices. | Retail analysts call editions to get every edition (set) on LigaOnePiece. | query, year |
| movers | The site's biggest price risers or fallers (Cards em Alta / em Queda): 50 cards with their current min/avg/max price in BRL and the change over the day, week and month for each, edition and number. | Pricing teams call movers to get the site's biggest price risers or fallers (Cards em Alta / em Queda). | direction, period |
| store | A marketplace store's public profile (store_id from card offers): name, website, logo, average rating over 12/6/3 months and all time with the per-aspect ratings (shipping, packaging, accuracy), contact phones/WhatsApp, e-mail, social links, address (or that it has no physical store), and customer reviews (rating, date, purchase value band, per-aspect stars, comment), 25 per page. | Marketplace operators call store to get a marketplace store's public profile (store_id from card offers). | store_id, reviews_page |
Call search from your stack
curl -X POST https://api.reefapi.com/ligaonepiece/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"Luffy"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/ligaonepiece/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "Luffy"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/ligaonepiece/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "Luffy"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.ligaonepiece.search with {"query":"Luffy"}.Who uses this API and why
- Track One Piece singles prices in Brazil by set release
- Compare foil premiums across a set
- Find sealed starter decks at the lowest Brazilian price
- Buy from the cheapest store and sell to the best buylist
Questions developers ask before integrating
How do I look up one card?
LigaOnePiece has one page per print, so search first. Each row gives card, edition_code and number, for example 'Ace & Sabo & Luffy (OP13-007)', OP-13 and OP13-007, and the card action takes those three as they are.
Are starter decks and boxes included?
Yes. Search returns sealed products as type=product with their minimum price, including English starter decks such as ST-21 and ST-30.
Are Foil and Normal prices separate?
Yes. Each print's price_guide has one line per finish with its own minimum, average and maximum, and each offer says whether it is foil. The foil filter on card keeps only one side.
Does it have sold prices?
No. Sales history on the site is shown only to signed-in users and this API does not use accounts. You get the current guide, offers, buylists and movers.
Does it cover other card games?
This API reads LigaOnePiece only. LigaMagic, LigaPokemon and LigaYugioh have their own APIs.
What is the LigaOnePiece API?
LigaOnePiece API is a ReefAPI endpoint group for brazil's one piece card game prices, normal and foil apart, with store offers and buylists, in brl. It returns live JSON through POST requests under /ligaonepiece/v1.
Is the LigaOnePiece API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. LigaOnePiece calls use the same shared credit balance as every other ReefAPI engine.
Do I need a LigaOnePiece login or account?
No login to LigaOnePiece 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 LigaOnePiece 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 LigaOnePiece API use?
LigaOnePiece actions currently cost 2-4 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call LigaOnePiece from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call ligaonepiece actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the LigaOnePiece API a LigaOnePiece scraper?
It is the managed alternative to a DIY LigaOnePiece 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 brazil's one piece card game prices, normal and foil apart, with store offers and buylists, in brl back as clean JSON.
Why does my LigaOnePiece scraper keep getting blocked?
Most LigaOnePiece 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.