SDKs & Tools

Official open-source libraries and tools for the TCG Price Lookup API. Every SDK is MIT-licensed and maintained on GitHub. Authentication is the same everywhere: pass your X-API-Key (grab one from your dashboard).

Official SDKs

JavaScript / TypeScript@tcgpricelookup/sdk

GitHub

Typed responses, auto-chunked batch lookup, typed errors and optional retry-on-429. Native fetch, zero dependencies, ESM + CJS. Node 18+, browsers, Workers, Bun, Deno.

npm i @tcgpricelookup/sdk

Pythontcglookup

GitHub

Pythonic client with typed models, sync and async support, and helpers for batch lookups and price history.

pip install tcglookup

Gotcglookup-go

GitHub

Idiomatic Go client with context support, typed structs, and built-in rate-limit handling.

go get github.com/TCG-Price-Lookup/tcglookup-go

Rusttcglookup

GitHub

Async Rust SDK built on reqwest/tokio with strongly-typed responses and ergonomic error handling.

cargo add tcglookup

PHPtcgpricelookup/sdk

GitHub

PSR-compatible PHP client with typed DTOs, Composer install, and Guzzle-based transport.

composer require tcgpricelookup/sdk

Quickstart (JavaScript)

Install the SDK, pass your API key, and search across any of the 8 supported games. Other languages follow the same shape, see each repo's README.

import { TcgLookupClient } from "@tcgpricelookup/sdk";

const tcg = new TcgLookupClient({ apiKey: "YOUR_API_KEY" });

const { data } = await tcg.cards.search({ q: "charizard", game: "pokemon" });
console.log(data[0]?.prices);

Command-line tool

Live trading card prices in your terminal, colored tables by default, --json for jq pipes. tcglookup-cli on GitHub.

# npm
npm i -g tcglookup

# or Homebrew
brew tap TCG-Price-Lookup/tcg && brew install tcglookup

# then
tcglookup auth login
tcglookup search "charizard" --game pokemon

Tools & resources

OpenAPI 3.1 specification

The full machine-readable API spec. Import it into Insomnia, generate clients, or feed it to your tooling.

Postman collection

Ready-to-run requests and an environment for every endpoint. Import and start testing in seconds.

Code examples (8 languages)

Working request/response examples across JavaScript, Python, Go, Rust, PHP, Java, Ruby and cURL.

Next.js starter

A Next.js 16 starter app wired to the API, so you can ship a card-price UI in minutes.

Discord bot (self-hosted)

Drop live card prices into your Discord server. Self-host with your own API key.

TCGVault — collection tracker

Open-source, self-hostable, bring-your-own-key TCG collection tracker built on the API.

awesome-tcg

A curated index of the entire TCG Price Lookup ecosystem: API, SDKs, tools and resources.