Onepiece Cardgame APIen.onepiece-cardgame.com ↗
Access card data, product listings, events, and news from the official One Piece Card Game site via 7 structured JSON endpoints.
What is the Onepiece Cardgame API?
This API exposes 7 endpoints covering the full official One Piece Card Game data catalog — cards, sets, products, events, news, and deck recommendations. The get_cards endpoint supports multi-dimensional filtering by color, series, card category, block icon, and keyword, returning paginated results with fields like power, counter, cost, attribute, effect text, and rarity. get_card_detail lets you pull granular stats for any individual card by its ID.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/d95a69ed-8e8c-4298-a782-fe16e8b84f09/get_card_series' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace en-onepiece-cardgame-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: One Piece Card Game SDK — search cards, get details, browse events."""
from parse_apis.one_piece_card_game_official_api import (
OnePieceCards, CardColor, CardCategory, CardNotFound
)
client = OnePieceCards()
# List available card series — single-page, cap total items fetched.
for series in client.serieses.list(limit=5):
print(series.series_id, series.series_name)
# Search for Red Leader cards by color and category.
card = client.cards.search(
colors=CardColor.RED, categories=CardCategory.LEADER, limit=1
).first()
if card:
print(card.name, card.power, card.color)
# Fetch full card details by ID — typed error catch.
try:
detail = client.cards.get(card_id="OP01-001")
print(detail.name, detail.rarity, detail.effect)
except CardNotFound as exc:
print(f"Card not found: {exc.card_id}")
# Browse upcoming events.
for event in client.events.list(limit=3):
print(event.title, event.date)
# Check latest products.
for product in client.products.list(limit=3):
print(product.name, product.release_date)
print("exercised: serieses.list / cards.search / cards.get / events.list / products.list")
Retrieves all available card sets (series) with their unique IDs. Each series entry contains a numeric series_id (used as a filter value in get_cards) and a human-readable series_name. The list is ordered newest-first and includes booster packs, starter decks, promo cards, and other product cards.
No input parameters required.
{
"type": "object",
"fields": {
"series": "array of series objects each with series_id and series_name"
},
"sample": {
"data": {
"series": [
{
"series_id": "569302",
"series_name": "PREMIUM BOOSTER -ONE PIECE CARD THE BEST vol.2- [PRB-02]"
},
{
"series_id": "569101",
"series_name": "BOOSTER PACK -ROMANCE DAWN- [OP-01]"
}
]
},
"status": "success"
}
}About the Onepiece Cardgame API
Card Data and Filtering
The get_cards endpoint accepts a POST request with optional filters: colors (comma-separated values such as Red, Blue, or mix), series (a series ID retrieved from get_card_series), categories (Leader, Character, Stage, or Event), block_icon (1–4), freewords for keyword search, and reprintsFlag to suppress reprint cards. Results are paginated via page and limit parameters. Each card object in the response includes id, name, rarity, category, cost, attribute, power, counter, color, block_icon, type, effect, and card (artwork reference).
Series, Products, and Deck Recommendations
get_card_series returns all available set IDs and names, which feed directly into the series filter on get_cards. get_products lists official releases — booster packs, starter decks, and accessories — with name, category, release_date, and image_url. get_recommended_decks returns officially published deck recipes with name, description, url, and image_url, sourced from the official site's strategy content.
Events and News
get_events returns upcoming and past events with title, date, category, url, and image_url. get_news provides the latest official announcements with title, date, category, and url. Both endpoints require no input parameters and reflect the current state of the official en.onepiece-cardgame.com site.
The Onepiece Cardgame API is a managed, monitored endpoint for en.onepiece-cardgame.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when en.onepiece-cardgame.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official en.onepiece-cardgame.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a card search tool that filters by color and card type using
get_cardswith thecolorsandcategoriesparameters. - Populate a card database with full stats — power, counter, cost, effect text — retrieved from
get_card_detailby card ID. - Track official product release dates for booster packs and starter decks using
get_products. - Display upcoming tournament and event listings in a community app using
get_events. - Surface official deck recommendations and strategies to players using
get_recommended_decks. - Keep a news feed updated with official One Piece Card Game announcements via
get_news. - Map every card to its series by combining
get_card_seriesIDs withget_cardsseries filtering.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the official One Piece Card Game site have a public developer API?+
How does get_card_detail differ from get_cards when looking up a specific card?+
get_card_detail takes a single card_id parameter (e.g. OP01-001) and returns the first exact match with the full detail object including effect, attribute, counter, and block_icon. get_cards is designed for filtered browsing across the full catalog and returns a paginated array, making get_card_detail the right choice when you already know the card ID.What is the pagination behavior of get_cards, and are all filter results available at once?+
page and limit parameters to simulate pagination over those results. This means the full filtered set is available, but very broad queries (no filters, large sets) may return large payloads before pagination is applied.Does the API expose card price or secondary market data?+
Is card artwork or full image data returned by the API?+
card field in card detail responses contains a reference to card artwork, and get_products, get_events, and get_recommended_decks each include an image_url field. However, the card listing in get_cards does not currently include a per-card image URL at the list level. You can fork this API on Parse and revise the response mapping to surface image URLs in card list results.