Skip to documentation
Developers
DOCUMENTATIONAPI referenceProductsGet card image URL
PRODUCTS / V1

Get card image URL

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

GET/v1/products/{productId}/image
Bearer key requiredJSON response

The API returns a URL; it does not copy or serve the image bytes.

Example requestv1
curl --request GET \  --url 'https://pokepos-market-api.vercel.app/v1/products/704860/image' \  --header 'Authorization: Bearer YOUR_API_KEY'
Response illustrative JSON
{  "source": "tcgplayer-public-site",  "productId": 704860,  "fetchedAt": "2026-09-29T12:30:00.000Z",  "cacheHit": true,  "imageUrl": "https://tcgplayer-cdn.tcgplayer.com/..."}
Example values can change with the source.
REQUEST

Parameters

Pass path parameters in the URL and query parameters after ?.

productIdintegerrequiredpath

Numeric TCGplayer product ID. Range: 1–any. Example: 716465.

RESPONSE

Response object

Source image URL. The root schema is ImageResult.

sourcestring

Name of the market data source.

productIdinteger

Numeric ID for the exact catalog product.

fetchedAtstring

Time this section was fetched, in ISO 8601 format.

cacheHitboolean

Whether the response used a cached observation.

imageUrlstring

Verified source URL for the product image.

HTTP

Status codes

200

Source image URL.

404

Product, route, or image not found.

502

An upstream market source is unavailable.

Errors use the error.code and error.message shape. Keep the x-request-id response header for support and tracing.

PREVIOUSGet current listingsNEXTList product lines