PriceCharting API

PriceCharting API

An SDK and REST API wrapper for PriceCharting providing structured access to pricing data across all supported categories: Pokemon, Lorcana, Magic: The Gathering, YuGiOh, Funko Pops, LEGO, Comics, and more.

Disclaimer: This SDK and REST API wrapper is an unofficial tool created for educational purposes only. It is not affiliated with, maintained, or endorsed by PriceCharting. Use of these tools may violate PriceCharting's terms of service.

Installation

npm install @deansasek/pricecharting-api

SDK

The SDK provides a typed, class-based interface for programmatic access.

import { PriceChartingClient } from '@deansasek/pricecharting-api/sdk';

const client = new PriceChartingClient({ requestDelay: 500 });

// Search for products
const results = await client.search('charizard', { category: 'pokemon-cards' });

// Get full product pricing data
const product = await client.getProductPrice('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

// Get product metadata
const meta = await client.getProductMeta('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

// Get available categories
const categories = await client.getCategories();

// Get groups/sets within a category
const groups = await client.getGroupList('pokemon-cards');

SDK Methods

SDK Example: Product Analysis

import { PriceChartingClient } from '@deansasek/pricecharting-api/sdk';

const client = new PriceChartingClient();

async function analyzeProduct(gameSlug: string, productSlug: string) {
  const result = await client.getProductPrice(gameSlug, productSlug);

  if (!result.success) {
    console.error('Failed to fetch product:', result.error);
    return;
  }

  console.log(`Product: ${result.cardName}`);
  console.log(`Category: ${result.category}`);
  console.log(`Grades available: ${result.grades.length}`);

  // Print grade prices
  for (const grade of result.grades) {
    console.log(`  ${grade.grade}: ${grade.price}`);
  }

  return result;
}

analyzeProduct('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

REST API (Flat Functions)

Flat function exports for direct API access, identical to SDK methods.

import { search, getProduct, autocomplete } from '@deansasek/pricecharting-api';

search(query, options?)

Search for products by name.

const results = await search('charizard', { category: 'pokemon-cards' });

autocomplete(query, category?)

Get autocomplete suggestions.

const suggestions = await autocomplete('char', 'pokemon-cards');

getCategories()

Get all available categories.

const categories = await getCategories();

getGroupList(category?)

Get all groups/sets within a category.

const groups = await getGroupList('pokemon-cards');

getProductPrice(gameSlug, productSlug)

Get full product data including pricing.

const product = await getProductPrice('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

getProductByUrl(url)

Get product data from a URL.

const product = await getProductByUrl('https://www.pricecharting.com/game/pokemon-scarlet-&-violet-151/charizard-ex-199');

getProductMeta(gameSlug, productSlug)

Get product metadata only.

const meta = await getProductMeta('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

Other Functions

REST API Server

HTTP server for network access.

Start the server

npm run dev    # Development with tsx
npm run build && npm start  # Production

HTTP Endpoints

Example Requests

# Search for Charizard cards
curl "http://localhost:3000/search?q=charizard&category=pokemon-cards"

# Get product pricing
curl "http://localhost:3000/products/pokemon-scarlet-%26-violet-151/charizard-ex-199"

# Get autocomplete suggestions
curl "http://localhost:3000/autocomplete?q=char&category=pokemon-cards"

# List Pokemon sets/groups
curl "http://localhost:3000/groups/pokemon-cards"

API Response Format

All endpoints return a consistent response structure:

// Success
{
  "success": true,
  "timestamp": "2026-08-07T00:00:00.000Z",
  // ... additional data
}

// Error
{
  "success": false,
  "timestamp": "2026-08-07T00:00:00.000Z",
  "error": "Error message"
}

Categories

PriceCharting supports multiple categories:

MCP Server (Claude Code Integration)

The MCP server enables Claude Code to interact with PriceCharting data directly.

Installation

Claude Code automatically detects .mcp.json:

{
  "mcpServers": {
    "pricecharting-api-mcp": {
      "command": "node",
      "args": ["dist/mcp/server.js"],
      "cwd": "/path/to/pricecharting"
    }
  }
}

Available MCP Tools

MCP Usage Examples

User: Search for Charizard cards on PriceCharting
Claude uses: pricecharting_search with query="charizard", category="pokemon-cards"

User: Get pricing for Charizard ex from Scarlet & Violet 151
Claude uses: pricecharting_product_price with gameSlug="pokemon-scarlet-&-violet-151", productSlug="charizard-ex-199"

User: What categories are available on PriceCharting?
Claude uses: pricecharting_categories

User: Show me all Pokemon sets/groups
Claude uses: pricecharting_groups with category="pokemon-cards"

Development

npm run build    # Compile TypeScript
npm run clean    # Remove dist folder
npm run dev      # Run server with tsx
npm start        # Run compiled server

Environment

• Node.js 18+ recommended (uses native fetch)
• TypeScript with strict mode
• ES Modules (type: "module")
• Uses JSDOM for HTML parsing (no browser/Playwright needed)

License

This project is dedicated to the public domain under the Unlicense.