Cards

List Cards

Get a paginated list of Pokemon cards with powerful filtering options.

Quick Examples:

  • Find by CardMarket ID: /cards?cardmarket_id=362170
  • Find by PokemonTCG ID: /cards?tcgid=sv3-223
  • Find by card number: /cards?card_number=125 or /cards?card_number=gg12
  • Powerful combo: /cards?name=Charizard&card_number=125
get/cards

Request

  • Base URL: https://pokemon-tcg-api.p.rapidapi.com
  • URL: https://pokemon-tcg-api.p.rapidapi.com/cards
  • Auth: none declared

Query parameters

searchstring

Search by name or card number (partial match)

namestring

Filter by card name only. Great for combining with card_number

idsstring

Batch filter by internal IDs (comma-separated, up to 20). Example: 24008,24009,24010

tcgidsstring

Batch filter by PokemonTCG IDs (comma-separated, up to 20). Example: sv3-199,sv3-200

cardmarket_idsstring

Batch filter by CardMarket IDs (comma-separated, up to 20). Example: 362170,362171

tcgidstring

Exact match by PokemonTCG ID. Example: sv3-223

cardmarket_idinteger

Exact match by CardMarket ID. Example: 362170

tcgplayer_idinteger

Exact match by TCGPlayer ID. Example: 632494

tcgplayer_idsstring

Batch filter by TCGPlayer IDs (comma-separated, up to 20). Example: 632494,632495

card_numberstring

Filter by card number (string|integer, e.g. 125, gg12, OP09-119)

episode_idinteger

Filter by expansion ID

artist_idinteger

Filter by artist ID

sort'relevance' | 'price_highest' | 'price_lowest' | 'card_number_highest' | 'card_number_lowest' | 'last_added' | 'episode_newest' | 'episode_oldest'

Sort order

per_pageinteger

Items per page (up to 100 when filtering by episode_id)

pageinteger

Response

List of cards

resultsinteger

Example response

{
  "data": [
    {
      "id": 3852,
      "name": "Giratina VSTAR",
      "name_numbered": "Giratina VSTAR GG69",
      "slug": "giratina-vstar",
      "type": "singles",
      "card_number": "GG69",
      "hp": 280,
      "rarity": "Rare Secret",
      "supertype": "Pokemon",
      "tcgid": "swsh12pt5gg-GG69",
      "cardmarket_id": 691949,
      "tcgplayer_id": 478100,
      "prices": {
        "cardmarket": {
          "currency": "EUR",
          "lowest_near_mint": 184.58,
          "lowest_near_mint_EU_only": 189.99,
          "lowest_near_mint_DE": 169.99,
          "lowest_near_mint_DE_EU_only": 175,
          "lowest_near_mint_FR": 159,
          "lowest_near_mint_FR_EU_only": 165.5,
          "lowest_near_mint_ES": 134.95,
          "lowest_near_mint_ES_EU_only": 139.95,
          "lowest_near_mint_IT": 235,
          "lowest_near_mint_IT_EU_only": 239,
          "graded": {
            "psa": {
              "psa10": 450,
              "psa9": 180,
              "psa8": 95
            },
            "bgs": {
              "bgs10black": 800,
              "bgs10pristine": 650,
              "bgs10": 500,
              "bgs9": 200,
              "bgs8": 100
            },
            "cgc": {
              "cgc10": 350,
              "cgc9": 150,
              "cgc8": 80
            }
          }
        },
        "ebay": {
          "currency": "USD",
          "graded": {
            "psa": {
              "9": {
                "median_price": 1200,
                "sample_size": 4
              },
              "10": {
                "median_price": 2941,
                "sample_size": 5
              }
            },
            "bgs": {
              "9": {
                "median_price": 1400,
                "sample_size": 5
              },
              "10": {
                "median_price": 3500,
                "sample_size": 3
              }
            }
          }
        }
      },
      "episode": {
        "id": 21,
        "name": "Crown Zenith",
        "slug": "crown-zenith",
        "released_at": "2023-01-20",
        "logo": "https://images.tcggo.com/tcggo/storage/3641/crown-zenith-logo.png",
        "code": "CRZ"
      },
      "artist": {
        "id": 434,
        "name": "AKIRA EGAWA",
        "slug": "akira-egawa"
      },
      "image": "https://images.tcggo.com/tcggo/storage/3871/giratina-vstar-crz-gg69-crown-zenith-pokemon.png",
      "tcggo_url": "https://www.tcggo.com/pokemon/crown-zenith/giratina-vstar-gg69",
      "links": {
        "cardmarket": "https://www.tcggo.com/external/cm/3852",
        "tcgplayer": "https://www.tcggo.com/external/tcgplayer/3852"
      }
    }
  ],
  "paging": {
    "current": 1,
    "total": 10,
    "per_page": 20
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.