Pokemon TCG Cards & Sets Scraper

Scrape the complete Pokemon Trading Card Game database — every set, every card, every rarity, every illustrator — with no API key, no login and no proxies. Built on the free, community-maintained TCGdex database, available in 6 languages.

One card = one row. One set = one row. Clean, flat JSON/CSV/Excel that drops straight into a database, a deck builder or a price-tracking pipeline.

Not the same as our Pokemon (video game) scraper. The Pokemon Scraper returns video-game species data from PokéAPI — base stats, abilities, moves, evolution chains, types for the RPG series. This actor is about the physical Trading Card Game: printed cards, set releases, rarities, illustrators, card variants (holo / reverse / 1st edition), regulation marks and tournament legality. Different domain, different database, different fields. Use both together if you want species data and card data.

What you get

Mode sets — the release history of the TCG

Every set from Base Set (1999) to the newest Scarlet & Violet expansion, with total / official / holo / reverse / 1st-edition card counts, serie, release date, logo, symbol and Standard / Expanded legality. Currently 218 sets.

Mode cards — every card of a set

Give it set IDs like swsh3 or base1 and get all cards of those sets, enriched with the full card detail.

Mode search — cards by name

Query Pikachu, Charizard or any partial name and get every printing across every set — 204 Pikachu cards and counting.

Sample output (card)

{
  "type": "card",
  "card_id": "swsh3-1",
  "local_id": "1",
  "name": "Butterfree V",
  "set_id": "swsh3",
  "set_name": "Darkness Ablaze",
  "serie": "Sword & Shield",
  "rarity": "Holo Rare V",
  "category": "Pokemon",
  "illustrator": "Saki Hayashiro",
  "hp": 190,
  "types": ["Grass"],
  "stage": "Basic",
  "evolve_from": null,
  "attack_count": 2,
  "attacks": [
    { "name": "Dizzying Poison", "damage": null, "cost_count": 1 },
    { "name": "Blasting Wind", "damage": "130", "cost_count": 3 }
  ],
  "weaknesses": ["Fire ×2"],
  "retreat_cost": 1,
  "regulation_mark": "D",
  "variant_normal": false,
  "variant_holo": true,
  "variant_reverse": false,
  "variant_first_edition": false,
  "legal_standard": false,
  "legal_expanded": true,
  "dex_ids": [12],
  "image_url": "https://assets.tcgdex.net/en/swsh/swsh3/1/high.png",
  "url": "https://www.tcgdex.net/en/swsh/swsh3/1",
  "source": "tcgdex",
  "scraped_at": "2026-07-28T14:36:29Z"
}

Sample output (set)

{
  "type": "set",
  "set_id": "base1",
  "set_name": "Base Set",
  "serie": "Base",
  "release_date": "1999-01-09",
  "card_count_total": 102,
  "card_count_official": 102,
  "card_count_holo": 64,
  "card_count_reverse": 0,
  "logo_url": "https://assets.tcgdex.net/en/base/base1/logo.png",
  "legal_standard": false,
  "legal_expanded": false,
  "source": "tcgdex",
  "scraped_at": "2026-07-28T14:36:23Z"
}

Input

Field	Type	Default	Description
mode	select	sets	sets, cards or search
setIds	array	["swsh3"]	Set IDs for cards mode
queries	array	["Pikachu","Charizard"]	Card names for search mode
language	select	en	en, fr, de, es, it, ja
enrichDetails	boolean	true	Fetch full detail per set/card (rarity, illustrator, attacks…)
maxItems	integer	200	Hard cap on dataset rows (max 2000)

{
  "mode": "search",
  "queries": ["Charizard"],
  "language": "en",
  "enrichDetails": true,
  "maxItems": 200
}

Use cases

• Card collection apps — build a complete card catalogue with images, rarities and set metadata without licensing a commercial API.
• Price-tracking pipelines — use card_id, set_id and local_id as stable join keys against marketplace price feeds (Cardmarket, TCGplayer, eBay).
• Deck builders — filter by legal_standard / legal_expanded, regulation_mark, types, hp and retreat_cost to validate tournament-legal decks.
• TCG marketplaces — auto-fill listings with official card names, set names, illustrators, rarity and high-resolution artwork.

Pricing

Roughly $0.5 per 1,000 items on the pay-per-usage model. The actor runs on 512 MB, makes plain HTTPS calls to a free API and needs no proxy — a full 200-set catalogue run finishes in about a minute.

Set enrichDetails to false for a much cheaper shallow run when you only need IDs, names and images.

Images

TCGdex asset URLs carry no file extension — the actor appends the right suffix for you, so image_url and logo_url are always directly usable (.../high.png). Other qualities (low.webp, high.jpg) follow the same pattern if you want to swap them client-side.

Notes & limits

• Data comes from the free TCGdex community database. Coverage is best in English; other languages may miss descriptions or newer sets.
• The search mode matches partial names, so Char also returns Charmander and Charizard printings.
• Some promo cards have no artwork on the CDN — image_url is null in that case rather than a broken link.
• Every field is nullable. Missing data is null, never an invented value.

Related actors

• Pokemon Scraper — video-game species data (stats, abilities, moves, evolutions) from PokéAPI
• Hearthstone Scraper — Hearthstone card database
• Scryfall MTG Scraper — Magic: The Gathering cards and prices
• Steam Search Scraper — Steam store listings and prices

Disclaimer

Pokemon and the Pokemon TCG are trademarks of Nintendo / Creatures Inc. / GAME FREAK inc. This actor is not affiliated with or endorsed by them. It reads publicly available data from the TCGdex open database for research, cataloguing and personal use.