• Stars
    star
    122
  • Rank 292,031 (Top 6 %)
  • Language
    JavaScript
  • Created about 8 years ago
  • Updated almost 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Pokemon TCG SDK - Javascript

Pokémon TCG SDK

Now Supporting Version 2 of the Pokémon TCG API!

pokemontcg-developers on discord npm version Build Status

This is the Pokémon TCG SDK Javascript implementation. It is a wrapper around the Pokémon TCG API of pokemontcg.io.

Installation

npm install --save pokemontcgsdk

Usage

Configuration

import pokemon from 'pokemontcgsdk'

pokemon.configure({apiKey: '123abc'})

Cards

Get a single card by ID

pokemon.card.find('base1-4')
.then(card => {
    console.log(card.name) // "Charizard"
})

Filter cards via the q parameter

pokemon.card.where({ q: 'name:blastoise' })
.then(result => {
    console.log(result.data[0].name) // "Blastoise"
})

Filter cards via the q parameter and specific page

pokemon.card.where({ q: 'name:blastoise', pageSize: 10, page: 3 })
.then(result => {
    console.log(result.data[0].name) // "Blastoise"
})

Automatically page through card data

pokemon.card.all({ q: 'name:blastoise' })
    .then((cards) => {
        console.log(cards[0].name) // "Blastoise"
    })

Using the all function, pagination happens automatically, and the result will simply contain the data and no pagination info.

Sets

Get a single set by ID

pokemon.set.find('base1')
.then(set => {
    console.log(set.name) // "Base"
})

Filter sets via the q parameter

pokemon.set.where({ q: 'series:base' })
.then(result => {
    console.log(result.data[0].name) // "Base"
})

Filter cards via the q parameter and specific page

pokemon.set.where({ q: 'series:base', pageSize: 1, page: 1 })
.then(result => {
    console.log(result.data[0].name) // "Base"
})

Automatically page through card data

pokemon.set.all({ q: 'series:base' })
    .then((cards) => {
        console.log(cards[0].name) // "Base"
    })

Using the all function, pagination happens automatically, and the result will simply contain the data and no pagination info.

Supertypes

pokemon.supertype.all()

Subtypes

pokemon.subtype.all()

Types

pokemon.type.all()

Rarity

pokemon.rarity.all()

Please refer to https://docs.pokemontcg.io for more information on query syntax and what fields are available.

Development

Build tasks are in npm scripts:

npm run build
npm run test