pkmncards.com 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.
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'
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 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)"
},
"sample": {
"data": {
"series": [
{
"sets": [
{
"url": "https://pkmncards.com/set/perfect-order/",
"name": "Perfect Order",
"slug": "perfect-order",
"abbreviation": "POR"
}
],
"series_name": "Mega Evolution"
}
]
},
"status": "success"
}
}About the pkmncards.com 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.
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.
- 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 | 250 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.