pkmncards APIpkmncards.com ↗
Search and retrieve Pokémon TCG card data from pkmncards.com. Access card stats, images, sets, and advanced filters across all expansions via 7 endpoints.
What is the pkmncards API?
This API exposes 7 endpoints for querying Pokémon TCG card data from pkmncards.com, covering everything from full set listings to per-card details including HP, attacks, rarity, and card images. The search_cards endpoint supports pkmncards.com's native search syntax with operators like name:, color:, and stage:, while get_card_detail returns fields such as illustrator, flavor text, weakness, resistance, and retreat cost for a single card slug.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e4850f94-26e1-4b28-9cd1-c5dda38c6c4f/list_sets' \ -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 pkmncards-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: PkmnCards SDK — browse sets, search cards, get details."""
from parse_apis.pkmncards_pokémon_tcg_api import PkmnCards, Color, Stage, CardNotFound
client = PkmnCards()
# List all series and their sets — one call returns the full hierarchy.
for series in client.serieses.list(limit=3):
print(series.series_name, "—", len(series.sets), "sets")
# Browse cards in a specific set using constructible Set.
for card in client.set(slug="ascended-heroes").cards.list(limit=5):
print(card.name, card.hp, card.rarity)
# Search for cards by keyword, drill into the first result for full detail.
card = client.cards.search(query="Pikachu", limit=1).first()
if card:
detail = client.cards.get(slug=card.slug)
print(detail.name, detail.hp, detail.color, detail.set_name)
# Filter by type using the Color enum.
for card in client.cards.by_type(pokemon_type=Color.FIRE, limit=3):
print(card.name, card.color, card.set_name)
# Advanced multi-attribute search with enum-typed stage filter.
for card in client.cards.advanced_search(color=Color.LIGHTNING, stage=Stage.BASIC, limit=3):
print(card.name, card.stage, card.rarity)
# Typed error handling for a missing card.
try:
client.cards.get(slug="nonexistent-card-slug-xyz-000")
except CardNotFound as exc:
print(f"Card not found: {exc.card_slug}")
print("exercised: serieses.list / set.cards.list / cards.search / cards.get / cards.by_type / cards.advanced_search")
List all available Pokémon TCG sets/expansions organized by series. Returns a hierarchical structure of series containing their respective sets with names, abbreviations, slugs, and URLs. No pagination — one request returns all series and sets.
No input parameters required.
{
"type": "object",
"fields": {
"series": "array of series objects, each containing series_name (string) and sets (array of objects with name, abbreviation, slug, url)"
}
}About the pkmncards API
Set and Card Browsing
list_sets returns a hierarchical array of series objects, each containing its child sets with name, abbreviation, slug, and url fields. This gives a complete picture of the available set catalog without requiring any parameters. Once you have a set_slug, pass it to get_cards_by_set to retrieve every card in that expansion — the response includes count, the requested set_slug, and a cards array with fields like hp, color, type, stage, rarity, image_jpg, and image_png.
Search and Advanced Filtering
search_cards accepts a query string that supports the full pkmncards.com search syntax — operators such as name:, color:, stage:, type:, rarity:, and set filters can be combined freely. The optional limit parameter controls how many pages of results (up to 20 cards each) are fetched. For structured filtering without learning query syntax, advanced_search accepts discrete parameters — name, color, stage, rarity, set_name, card_type, text, and format_name — and returns the constructed query string alongside the results so you can inspect or extend it.
Species and Type Lookups
get_cards_by_pokemon retrieves up to 100 cards for a given Pokémon species (e.g., Charizard, Eevee) across all sets. get_cards_by_type does the same filtered by energy color such as Lightning, Fire, or Psychic. Both endpoints return the same card object shape — name, hp, color, type, stage, rarity, set_name, image_jpg, image_png, and slug — plus a count and the query used.
Single Card Detail
get_card_detail takes a card_slug (e.g., pikachu-ascended-heroes-asc-055) and returns the most complete card record available: name, hp, type, color, stage, rarity, set_name, image URLs, illustrator, flavor_text, attacks, weakness, resistance, and retreat_cost. This is the right endpoint when you need the full data profile for a specific card rather than bulk results.
The pkmncards API is a managed, monitored endpoint for pkmncards.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when pkmncards.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 pkmncards.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 database app that lets users browse all sets via
list_setsand drill into individual expansions withget_cards_by_set. - Create a deck-builder tool that filters cards by
stage,color, andformat_nameusingadvanced_search. - Populate a Pokédex-style reference showing every card ever printed for a species using
get_cards_by_pokemon. - Index card images at multiple resolutions (
image_jpg,image_png) for a visual card gallery or print reference. - Track rarity distribution across a set by aggregating the
rarityfield fromget_cards_by_setresults. - Power a card identification tool that resolves a card slug from search results to full detail via
get_card_detail, includingillustratorandflavor_text. - Filter Standard or Expanded format card pools using the
format_nameparameter inadvanced_search.
| 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 pkmncards.com have an official developer API?+
What does `get_card_detail` return beyond what search endpoints provide?+
get_card_detail returns fields not included in bulk results: attacks, weakness, resistance, retreat_cost, illustrator, and flavor_text. Search and browse endpoints return the core card object — name, hp, color, type, stage, rarity, set_name, and image URLs — but omit those per-card detail fields.How does pagination work in `search_cards`?+
limit parameter caps how many pages are fetched. If limit is not set, the endpoint applies a default cap. There is no cursor or offset parameter; pagination is page-count-based.Does the API return card market prices or auction history?+
Can I retrieve cards from a specific numbered range within a set?+
get_cards_by_set returns all cards in a set and includes each card's slug, which typically encodes the card number. You can filter the returned array client-side by the slug pattern. You can also fork this API on Parse and revise it to add a number-range filter endpoint.