tcg-api-postman

Official Postman collection + environment for the TCG Price Lookup API — live trading card prices for Pokémon, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece TCG, Star Wars: Unlimited, and Flesh and Blood.

Drop the collection into Postman, paste your API key into the environment, and you're hitting the live API in 30 seconds.

What's in the box

• tcg-price-lookup.postman_collection.json — every endpoint pre-configured with sensible example parameters
• tcg-price-lookup.postman_environment.json — environment template with base_url and api_key variables

Endpoints covered

Method	Path	Description	Plan
GET	/v1/cards/search	Search cards by name, batch IDs, game, or set	Free
GET	/v1/cards/{id}	Fetch one card by UUID with full price block	Free
GET	/v1/cards/{id}/history	Daily price history (7d / 30d / 90d / 1y)	Trader
GET	/v1/sets	List sets, optionally filtered by game	Free
GET	/v1/games	List every supported game with catalogue size	Free

Use it

In Postman desktop / web

1. File → Import
2. Paste this raw URL: https://raw.githubusercontent.com/TCG-Price-Lookup/tcg-api-postman/main/tcg-price-lookup.postman_collection.json
3. Also import the environment file the same way
4. Select the environment in the top-right dropdown
5. Edit it and paste your API key into api_key (get one free at tcgpricelookup.com/tcg-api)
6. Open any request and hit Send

Via Newman (CLI)

Run the entire collection from your terminal or CI:

npm install -g newman
newman run tcg-price-lookup.postman_collection.json \
  --env-var "api_key=tlk_live_..." \
  --env-var "base_url=https://api.tcgpricelookup.com/v1"

Via Insomnia

Insomnia natively imports Postman collections. Application → Preferences → Data → Import Data → From File → pick the JSON.

Authentication

The collection uses Postman's API Key auth at the collection level. Every request inherits it automatically — no per-request setup needed.

The auth header sent is:

X-API-Key: {{api_key}}

Set api_key once in the environment, then all requests authenticate. Get a free API key at tcgpricelookup.com/tcg-api. Free tier includes 10,000 requests per month.

Sister projects

• awesome-tcg — full TCG Price Lookup ecosystem index
• tcg-api-openapi — OpenAPI 3.1 spec for the same API
• tcg-api-examples — runnable code samples in 8 languages

License

MIT — see LICENSE.

---

Built and maintained by TCG Price Lookup. Get a free API key at tcgpricelookup.com/tcg-api.