MARKET DATA / V1

API reference

The Market Data API uses resource-oriented URLs, standard HTTP methods, bearer authentication, and JSON responses. Browse every operation below or use the left navigation to jump directly to a call.

Read the quickstart OpenAPI spec

BASE URLhttps://pokepos-market-api.vercel.app

AUTHENTICATIONAuthorization: Bearer YOUR_API_KEYExcept the public plans route

FORMATapplication/json

Use the exact printing.

Product prices and history are attached to specific SKUs. Keep condition, variant, and language with the observation. Missing prices are returned as null.

ENDPOINTS / CARDS

Cards

GETIdentify a card/v1/identify

Resolve a Pokémon name and collector number into ranked product candidates. Add a set hint when the same card appears in multiple printings.

POSTIdentify from image/v1/identify-image

Send a card photo as a data URL. OCR suggests a query and returns ranked matches when enough text is readable.

ENDPOINTS / PRODUCTS

Products

GETLook up a URL/v1/lookup

Start with a TCGplayer product URL or ID and receive the same market snapshot as the product endpoint.

GETGet a product snapshot/v1/products/{productId}

Read product identity, image URL, SKU market prices, history, and current listings in one request.

GETGet product details/v1/products/{productId}/details

Read the exact product identity, set, card attributes, SKU variants, and verified card image URL.

GETGet market prices/v1/products/{productId}/prices

Read price observations for each SKU with its condition, variant, and language attached.

GETGet price history/v1/products/{productId}/history

Read chronological market price and sales volume buckets for each product SKU.

GETGet current listings/v1/products/{productId}/listings

Page through seller offers with condition, quantity, item price, shipping, and total price.

GETGet card image URL/v1/products/{productId}/image

Return a verified source URL for the card image. Your client loads the image from that URL.

ENDPOINTS / CATALOG

Catalog

GETList product lines/v1/categories

Discover available product categories before browsing sets or searching products.

GETList sets/v1/categories/{category}/sets

List the sets within one product line, including catalog counts and slugs for narrowing searches.

GETSearch products/v1/search

Find products by name, category, and set. Use offset and limit to page through catalog results.

ENDPOINTS / ACCOUNT

Account

GETList plans/v1/plans

Read the published request limits for Starter, Growth, and Scale. This route does not require a key.

GETGet account usage/v1/usage

Check how much of your account allowance remains in the current minute and UTC month.

Need account access or a larger request allowance?

Compare plans