$ newman run tcg-api-collection.json --env-var "apiKey=YOUR_KEY"

Test the API
Without Writing Code

A ready-to-use Postman collection and environment JSON for the TCG Price Lookup API. Every endpoint is pre-configured with examples. Import, set your key, send your first request.

Collection + Environment | Every Endpoint Pre-configured | Postman Desktop & Web | Insomnia | Newman CLI

Three Steps to Your First Request

No code. No configuration. Just import and go.

01

Import

Download both JSON files from GitHub. In Postman, use File → Import and select both the collection and the environment file.

02

Set Your API Key

Select the "TCG Price Lookup" environment from the top-right dropdown. Set the apiKey variable to your key. Auth is inherited by all requests.

03

Send a Request

Open any request from the collection sidebar and hit Send. Every request includes example params and a description of the response.

Postman

TCG Price Lookup

GET Search Cards
GET Get Card by ID
GET Price History
GET List Games
GET List Sets
GET https://api.tcgpricelookup.com/v1/cards?q=charizard&game=pokemon
Send
Response — 200 OK
{
  "data": [
    { "id": "abc-123", "name": "Charizard",
      "prices": { "nm": 280.00, "lp": 210.00 } }
  ],
  "total": 12
}

Auth Inherited at Collection Level

The collection is configured with API key auth at the top level. Set your key once in the environment, and every request in the collection picks it up automatically — no per-request configuration needed.

The environment file ships with a placeholder apiKey variable. Replace it with your key from tcgpricelookup.com and you're done.

tcg-api-environment.json
{
  "name": "TCG Price Lookup",
  "values": [
    {
      "key": "apiKey",
      "value": "YOUR_API_KEY_HERE",
      "enabled": true
    }
  ]
}

Newman CLI for CI/CD

Run the collection as part of your CI pipeline with Newman — the command-line runner for Postman collections. Catch API regressions automatically on every deploy.

terminal newman
# Install Newman
$ npm install -g newman

# Run the full collection
$ newman run tcg-api-collection.json \
    -e tcg-api-environment.json \
    --env-var "apiKey=$TCG_API_KEY" \
    --reporters cli,junit \
    --reporter-junit-export results.xml
.github/workflows/api-test.yml GitHub Actions
- name: Run API tests
  run: |
    npm install -g newman
    newman run tcg-api-collection.json \
      -e tcg-api-environment.json \
      --env-var "apiKey=${{  secrets.TCG_API_KEY  }}"

Endpoints in the Collection

Method Endpoint Description
GET /v1/cards Search cards across all games
GET /v1/cards/{id} Get a card by UUID with full pricing
GET /v1/cards/{id}/history Price history (Trader plan)
GET /v1/games List supported games
GET /v1/sets List sets with optional game filter

Ready to explore the API?

Download the collection from GitHub and start testing. Free plan — 200 requests/day, no credit card needed.