pokemontcgsdk
v2.0.0
Published
Pokémon TCG SDK is a javascript wrapper around the Pokémon TCG API located at pokemontcg.io
Downloads
1,383
Readme
Pokémon TCG SDK
Now Supporting Version 2 of the Pokémon TCG API!
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
- (nwb)
Build tasks are in npm scripts:
npm run build
npm run test