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.
https://pokepos-market-api.vercel.appAuthorization: Bearer YOUR_API_KEYExcept the public plans routeapplication/jsonProduct prices and history are attached to specific SKUs. Keep condition, variant, and language with the observation. Missing prices are returned as null.
Cards
Rank printing candidates and expose match evidence. Explicit number conflicts are excluded. matchScore is a heuristic, not a probability. Retrieval inspects at most 50 products without a collector number and 200 with one.
POSTIdentify from image/v1/identify-imageOCR a PNG, JPEG or WebP data URL. Accepts 100–3,000,000 decoded bytes, at most 16,000,000 pixels and 8,000 pixels per dimension. JSON body cap: 4,100,000 bytes. Successful OCR survives an identification outage.
Products
Look up a product URL
GETGet a product snapshot/v1/products/{productId}Combine identity, enriched SKU prices, history, listings and checked image URL. Timing belongs in sections; embedded history/listings contain data, not endpoint envelopes.
GETGet product details/v1/products/{productId}/detailsRead product identity, set, attributes and SKU variants. This focused route does not verify an image: product.imageUrl is null. Use /image or the snapshot for a checked URL.
GETGet market prices/v1/products/{productId}/pricesRead per-SKU observations with condition, variant and language. Missing observations never become invented zero prices.
GETGet price history/v1/products/{productId}/historyGet price history
GETGet current listings/v1/products/{productId}/listingsGet current listings
GETGet card image URL/v1/products/{productId}/imageReturn a checked source image URL. The API does not copy or serve image bytes; display permission is a separate source-rights question.
Catalog
Account
Need account access or a larger request allowance?
Compare plans