Get a product snapshot
Combine identity, enriched SKU prices, history, listings and checked image URL. Timing belongs in sections; embedded history/listings contain data, not endpoint envelopes.
/v1/products/{productId}Use sections.prices/history/listings/spotlight/image. Unavailable payloads are null; stale payloads retain original fetchedAt. Empty prices are []; empty history has variants:[]; empty listings has offers:[]. Absent image/featured offer may be null with status ok.
curl --request GET --max-time 35 \ --url 'https://pokepos-market-api.vercel.app/v1/products/704860?range=quarter&limit=10' \ --header "Authorization: Bearer $CARDCOUNTER_API_KEY"{ "source": "tcgplayer-public-site", "sourceUrl": "https://www.tcgplayer.com/product/704860", "observedAt": "2026-10-04T12:30:00.000Z", "currency": "USD", "product": { "productId": 704860, "sourceUrl": "https://www.tcgplayer.com/product/704860", "name": "Example Pokémon card", "category": { "id": 3, "name": "Pokemon" }, "group": { "id": 100, "name": "Example set", "code": "EXM" }, "productType": "Cards", "sealed": false, "cardNumber": "066/128", "rarity": "Rare", "attributes": { "number": "066/128" }, "formattedAttributes": {}, "skus": [ { "skuId": 123, "condition": "Near Mint", "variant": "Holofoil", "language": "English" } ], "marketPrice": 5.45, "lowestPrice": 3, "lowestPriceWithShipping": 4.99, "listingCount": 1, "sellerCount": 1, "imageCount": 1, "imageUrl": "https://tcgplayer-cdn.tcgplayer.com/product/704860_in_1000x1000.jpg" }, "marketPrices": [ { "skuId": 123, "condition": "Near Mint", "variant": "Holofoil", "language": "English", "marketPrice": 5.45, "lowSalePrice": 3, "highSalePrice": 8, "sampleSize": 25, "calculatedAt": "2026-10-04T12:30:00.000Z" } ], "priceCoverage": { "requestedSkuIds": [ 123 ], "missingSkuIds": [] }, "marketHistory": { "range": "quarter", "variants": [ { "skuId": 123, "condition": "Near Mint", "variant": "Holofoil", "language": "English", "averageDailyQuantitySold": 1, "averageDailyTransactionCount": 1, "totalQuantitySold": 25, "totalTransactionCount": 25, "buckets": [ { "date": "2026-10-01", "marketPrice": 5.45, "quantitySold": 2, "transactionCount": 2, "lowSalePrice": 3, "highSalePrice": 8, "lowSalePriceWithShipping": 4.99, "highSalePriceWithShipping": 9.99 } ] } ] }, "listings": { "total": 1, "offset": 0, "limit": 10, "sort": "price", "offers": [ { "listingId": 456, "skuId": 123, "seller": { "id": "example-seller", "name": "Example seller", "ratingPercent": 99, "sales": "100+", "direct": false, "verified": true }, "condition": "Near Mint", "variant": "Holofoil", "language": "English", "quantity": 2, "itemPrice": 3, "shippingPrice": 1.99, "totalPrice": 4.99, "currency": "USD", "listingType": "standard" } ] }, "featuredListing": { "listingId": 456, "skuId": 123, "seller": { "id": "example-seller", "name": "Example seller", "ratingPercent": 99, "sales": "100+", "direct": false, "verified": true }, "condition": "Near Mint", "variant": "Holofoil", "language": "English", "quantity": 2, "itemPrice": 3, "shippingPrice": 1.99, "totalPrice": 4.99, "currency": "USD", "listingType": "standard" }, "sections": { "details": { "status": "ok", "fetchedAt": "2026-10-04T12:30:00.000Z", "cacheHit": false }, "prices": { "status": "ok", "fetchedAt": "2026-10-04T12:30:00.000Z", "cacheHit": false }, "history": { "status": "ok", "fetchedAt": "2026-10-04T12:30:00.000Z", "cacheHit": false }, "listings": { "status": "ok", "fetchedAt": "2026-10-04T12:30:00.000Z", "cacheHit": false }, "spotlight": { "status": "ok", "fetchedAt": "2026-10-04T12:30:00.000Z", "cacheHit": false }, "image": { "status": "ok", "fetchedAt": "2026-10-04T12:30:00.000Z", "cacheHit": false } }}Parameters
Pass path parameters in the URL and query parameters after ?.
productIdintegerrequiredpathPositive numeric TCGplayer product ID, up to ten digits. Range: 1–9999999999. Example: 704860.
rangestringqueryHistory window; aliases normalize to long names in responses. Values: month, quarter, semi-annual, annual, 1m, 3m, 6m, 1y. Default: quarter.
offsetintegerqueryZero-based index of the first result to return. Range: 0–10000. Default: 0.
limitintegerqueryMaximum number of results to include in this response. Range: 1–100. Default: 50.
sortstringqueryItem-price order; totals including shipping can be out of order. Values: price, none. Default: price.
Response object
Get a product snapshot The root schema is ProductSnapshot.
sourcestringrequiredAlways tcgplayer-public-site.
sourceUrlstringrequiredSource product page URL.
observedAtstringrequiredTime this response was assembled; it does not imply all sections were refreshed.
currencystringrequiredAlways USD.
productProductrequiredIdentity and attributes of the selected product.
marketPricesPrice[] | nullrequiredSKU-level current market price observations.
priceCoveragePriceCoverage | nullrequiredRequested and missing SKU IDs; missing rows are not authoritative zero-price observations.
marketHistoryHistoryData | nullrequiredPrice and volume history for the selected range.
listingsListingsData | nullrequiredCurrent seller listings and pagination data.
featuredListingOffer | nullrequiredFeatured seller offer when the source provides one.
sectionsobjectrequiredAvailability and fetch status for each snapshot section.
Fields in sections
sections.detailsSectionStatusrequiredValue returned by the market data source.
sections.pricesSectionStatusrequiredMarket price observations grouped by SKU.
sections.historySectionStatusrequiredValue returned by the market data source.
sections.listingsSectionStatusrequiredCurrent seller listings and pagination data.
sections.spotlightSectionStatusrequiredValue returned by the market data source.
sections.imageSectionStatusrequiredValue returned by the market data source.
Related objects
Expand a type to inspect its fields.
Product19 fields
productIdintegerrequiredNumeric ID for the exact catalog product.
sourceUrlstringrequiredSource product page URL.
namestringrequiredDisplay name from the source catalog.
categoryobjectrequiredProduct line or category for this result.
Fields in category
category.idinteger | nullrequiredIdentifier for this item or seller.
category.namestring | nullrequiredDisplay name from the source catalog.
groupobjectrequiredSet or group metadata from the source catalog.
Fields in group
group.idinteger | nullrequiredIdentifier for this item or seller.
group.namestring | nullrequiredDisplay name from the source catalog.
group.codestring | nullrequiredMachine-readable status or error code.
productTypestring | nullrequiredProduct type reported by the catalog.
sealedbooleanrequiredWhether the product is sealed rather than a single card.
cardNumberstring | nullrequiredCollector number printed on the card.
raritystring | nullrequiredRarity label reported by the catalog.
attributesobjectrequiredStructured product attributes.
formattedAttributesobjectrequiredSource-formatted product attributes.
skusSku[]requiredConditions, finishes, and languages offered for this product.
marketPricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
lowestPricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
lowestPriceWithShippingnumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
listingCountinteger | nullrequiredNumber of current listings, when reported.
sellerCountinteger | nullrequiredNumber of current sellers, when reported.
imageCountinteger | nullrequiredNumber of source product images when reported.
imageUrlstring | nullrequiredVerified source URL for the product image.
Sku4 fields
skuIdintegerrequiredNumeric ID of one condition and variant combination.
conditionstring | nullrequiredCard condition associated with this SKU or offer.
variantstring | nullrequiredPrinting finish or variant associated with this SKU or offer.
languagestring | nullrequiredLanguage associated with this SKU or offer.
Price9 fields
skuIdintegerrequiredNumeric ID of one condition and variant combination.
conditionstring | nullrequiredCard condition associated with this SKU or offer.
variantstring | nullrequiredPrinting finish or variant associated with this SKU or offer.
languagestring | nullrequiredLanguage associated with this SKU or offer.
marketPricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
lowSalePricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
highSalePricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
sampleSizeinteger | nullrequiredNumber of observations used by the source calculation.
calculatedAtstring | nullrequiredTime the source calculated this price.
PriceCoverage2 fields
requestedSkuIdsinteger[]requiredSKU IDs requested for this product.
missingSkuIdsinteger[]requiredRequested SKU IDs for which the source returned no row.
HistoryData2 fields
rangestringrequiredOne of month, quarter, semi-annual, annual.
variantsHistoryVariant[]requiredPer-SKU market history series.
HistoryVariant9 fields
skuIdintegerrequiredNumeric ID of one condition and variant combination.
conditionstring | nullrequiredCard condition associated with this SKU or offer.
variantstring | nullrequiredPrinting finish or variant associated with this SKU or offer.
languagestring | nullrequiredLanguage associated with this SKU or offer.
averageDailyQuantitySoldnumber | nullrequiredAverage items sold per day in this range.
averageDailyTransactionCountnumber | nullrequiredAverage daily transactions reported for the range.
totalQuantitySoldinteger | nullrequiredTotal items sold in this range.
totalTransactionCountinteger | nullrequiredTransactions observed in this history range.
bucketsHistoryBucket[]requiredChronological price and sales observations.
HistoryBucket8 fields
datestring | nullrequiredDate of this history bucket.
marketPricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
quantitySoldinteger | nullrequiredItems sold in this history bucket.
transactionCountinteger | nullrequiredSale transactions in this history bucket.
lowSalePricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
highSalePricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
lowSalePriceWithShippingnumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
highSalePriceWithShippingnumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
ListingsData5 fields
totalinteger | nullrequiredNumber of matching results or offers reported by the source.
offsetintegerrequiredZero-based offset used for this page.
limitintegerrequiredMaximum results requested for this page.
sortstringrequiredOne of price, none.
offersOffer[]requiredCurrent seller offers for the selected page.
Offer12 fields
listingIdintegerrequiredSource identifier for this specific offer.
skuIdinteger | nullrequiredNumeric ID of one condition and variant combination.
sellerSellerrequiredSeller identity and reputation metadata.
conditionstring | nullrequiredCard condition associated with this SKU or offer.
variantstring | nullrequiredPrinting finish or variant associated with this SKU or offer.
languagestring | nullrequiredLanguage associated with this SKU or offer.
quantityinteger | nullrequiredAvailable quantity on this offer.
itemPricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
shippingPricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
totalPricenumber | nullrequiredUSD decimal dollars. Null means no usable observation, not zero.
currencystringrequiredAlways USD.
listingTypestring | nullrequiredSource offer category when reported.
Seller6 fields
idstring | nullrequiredIdentifier for this item or seller.
namestring | nullrequiredDisplay name from the source catalog.
ratingPercentnumber | nullrequiredSeller rating percentage, when available.
salesstring | number | nullrequiredSource-formatted seller sales count.
directbooleanrequiredWhether the offer participates in source direct fulfillment.
verifiedbooleanrequiredWhether the source marks this seller as verified.
SectionStatus5 fields
statusstringrequiredOne of ok, stale, unavailable.
fetchedAtstringTime this section was fetched, in ISO 8601 format.
cacheHitbooleanWhether a cached observation was served. Read fetchedAt and stale together.
codestringMachine-readable status or error code.
upstreamStatusinteger | nullHTTP status reported by an upstream source, when known.
Status codes
Get a product snapshot
Check route parameters or the JSON body.
Account-backed key is invalid, inactive, expired or revoked.
Unknown route.
Use the method published for this route.
Quota or admission limit; inspect error.code and Retry-After.
Request failed; preserve x-request-id for support.
The source returned an error. Source 404 may map to API 404.
Account access store is unavailable or misconfigured.
Source request exceeded its budget.
Errors use error.code and error.message. Keep x-request-id for tracing. Read the error code catalog and examples.
Response headers
x-request-idRequest ID for tracing and support.
x-planPlan for admitted account-backed requests.
x-ratelimit-limitAccount allowance per UTC minute.
x-ratelimit-remainingRemaining requests in the UTC minute.
x-monthly-limitAccount allowance per UTC month.
x-monthly-remainingRemaining requests in the UTC month.
Retry-AfterNonnegative seconds until retry is useful for quota, cooldown or admission failures.
Success, empty, partial, stale and error examples
200 · success
{
"source": "tcgplayer-public-site",
"sourceUrl": "https://www.tcgplayer.com/product/704860",
"observedAt": "2026-10-04T12:30:00.000Z",
"currency": "USD",
"product": {
"productId": 704860,
"sourceUrl": "https://www.tcgplayer.com/product/704860",
"name": "Example Pokémon card",
"category": {
"id": 3,
"name": "Pokemon"
},
"group": {
"id": 100,
"name": "Example set",
"code": "EXM"
},
"productType": "Cards",
"sealed": false,
"cardNumber": "066/128",
"rarity": "Rare",
"attributes": {
"number": "066/128"
},
"formattedAttributes": {},
"skus": [
{
"skuId": 123,
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English"
}
],
"marketPrice": 5.45,
"lowestPrice": 3,
"lowestPriceWithShipping": 4.99,
"listingCount": 1,
"sellerCount": 1,
"imageCount": 1,
"imageUrl": "https://tcgplayer-cdn.tcgplayer.com/product/704860_in_1000x1000.jpg"
},
"marketPrices": [
{
"skuId": 123,
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"marketPrice": 5.45,
"lowSalePrice": 3,
"highSalePrice": 8,
"sampleSize": 25,
"calculatedAt": "2026-10-04T12:30:00.000Z"
}
],
"priceCoverage": {
"requestedSkuIds": [
123
],
"missingSkuIds": []
},
"marketHistory": {
"range": "quarter",
"variants": [
{
"skuId": 123,
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"averageDailyQuantitySold": 1,
"averageDailyTransactionCount": 1,
"totalQuantitySold": 25,
"totalTransactionCount": 25,
"buckets": [
{
"date": "2026-10-01",
"marketPrice": 5.45,
"quantitySold": 2,
"transactionCount": 2,
"lowSalePrice": 3,
"highSalePrice": 8,
"lowSalePriceWithShipping": 4.99,
"highSalePriceWithShipping": 9.99
}
]
}
]
},
"listings": {
"total": 1,
"offset": 0,
"limit": 10,
"sort": "price",
"offers": [
{
"listingId": 456,
"skuId": 123,
"seller": {
"id": "example-seller",
"name": "Example seller",
"ratingPercent": 99,
"sales": "100+",
"direct": false,
"verified": true
},
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"quantity": 2,
"itemPrice": 3,
"shippingPrice": 1.99,
"totalPrice": 4.99,
"currency": "USD",
"listingType": "standard"
}
]
},
"featuredListing": {
"listingId": 456,
"skuId": 123,
"seller": {
"id": "example-seller",
"name": "Example seller",
"ratingPercent": 99,
"sales": "100+",
"direct": false,
"verified": true
},
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"quantity": 2,
"itemPrice": 3,
"shippingPrice": 1.99,
"totalPrice": 4.99,
"currency": "USD",
"listingType": "standard"
},
"sections": {
"details": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"prices": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"history": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"listings": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"spotlight": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"image": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
}
}
}200 · empty
{
"source": "tcgplayer-public-site",
"sourceUrl": "https://www.tcgplayer.com/product/704860",
"observedAt": "2026-10-04T12:30:00.000Z",
"currency": "USD",
"product": {
"productId": 704860,
"sourceUrl": "https://www.tcgplayer.com/product/704860",
"name": "Example Pokémon card",
"category": {
"id": 3,
"name": "Pokemon"
},
"group": {
"id": 100,
"name": "Example set",
"code": "EXM"
},
"productType": "Cards",
"sealed": false,
"cardNumber": "066/128",
"rarity": "Rare",
"attributes": {
"number": "066/128"
},
"formattedAttributes": {},
"skus": [
{
"skuId": 123,
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English"
}
],
"marketPrice": 5.45,
"lowestPrice": 3,
"lowestPriceWithShipping": 4.99,
"listingCount": 1,
"sellerCount": 1,
"imageCount": 0,
"imageUrl": null
},
"marketPrices": [],
"priceCoverage": {
"requestedSkuIds": [
123
],
"missingSkuIds": [
123
]
},
"marketHistory": {
"range": "quarter",
"variants": []
},
"listings": {
"total": 0,
"offset": 0,
"limit": 10,
"sort": "price",
"offers": []
},
"featuredListing": null,
"sections": {
"details": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"prices": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"history": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"listings": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"spotlight": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"image": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
}
}
}200 · partial
{
"source": "tcgplayer-public-site",
"sourceUrl": "https://www.tcgplayer.com/product/704860",
"observedAt": "2026-10-04T12:30:00.000Z",
"currency": "USD",
"product": {
"productId": 704860,
"sourceUrl": "https://www.tcgplayer.com/product/704860",
"name": "Example Pokémon card",
"category": {
"id": 3,
"name": "Pokemon"
},
"group": {
"id": 100,
"name": "Example set",
"code": "EXM"
},
"productType": "Cards",
"sealed": false,
"cardNumber": "066/128",
"rarity": "Rare",
"attributes": {
"number": "066/128"
},
"formattedAttributes": {},
"skus": [
{
"skuId": 123,
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English"
}
],
"marketPrice": 5.45,
"lowestPrice": 3,
"lowestPriceWithShipping": 4.99,
"listingCount": 1,
"sellerCount": 1,
"imageCount": 1,
"imageUrl": "https://tcgplayer-cdn.tcgplayer.com/product/704860_in_1000x1000.jpg"
},
"marketPrices": [
{
"skuId": 123,
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"marketPrice": 5.45,
"lowSalePrice": 3,
"highSalePrice": 8,
"sampleSize": 25,
"calculatedAt": "2026-10-04T12:30:00.000Z"
}
],
"priceCoverage": {
"requestedSkuIds": [
123
],
"missingSkuIds": []
},
"marketHistory": null,
"listings": {
"total": 1,
"offset": 0,
"limit": 10,
"sort": "price",
"offers": [
{
"listingId": 456,
"skuId": 123,
"seller": {
"id": "example-seller",
"name": "Example seller",
"ratingPercent": 99,
"sales": "100+",
"direct": false,
"verified": true
},
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"quantity": 2,
"itemPrice": 3,
"shippingPrice": 1.99,
"totalPrice": 4.99,
"currency": "USD",
"listingType": "standard"
}
]
},
"featuredListing": {
"listingId": 456,
"skuId": 123,
"seller": {
"id": "example-seller",
"name": "Example seller",
"ratingPercent": 99,
"sales": "100+",
"direct": false,
"verified": true
},
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"quantity": 2,
"itemPrice": 3,
"shippingPrice": 1.99,
"totalPrice": 4.99,
"currency": "USD",
"listingType": "standard"
},
"sections": {
"details": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"prices": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"history": {
"status": "unavailable",
"code": "UPSTREAM_HTTP_503",
"upstreamStatus": 503
},
"listings": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"spotlight": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"image": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
}
}
}200 · stale
{
"source": "tcgplayer-public-site",
"sourceUrl": "https://www.tcgplayer.com/product/704860",
"observedAt": "2026-10-04T12:30:00.000Z",
"currency": "USD",
"product": {
"productId": 704860,
"sourceUrl": "https://www.tcgplayer.com/product/704860",
"name": "Example Pokémon card",
"category": {
"id": 3,
"name": "Pokemon"
},
"group": {
"id": 100,
"name": "Example set",
"code": "EXM"
},
"productType": "Cards",
"sealed": false,
"cardNumber": "066/128",
"rarity": "Rare",
"attributes": {
"number": "066/128"
},
"formattedAttributes": {},
"skus": [
{
"skuId": 123,
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English"
}
],
"marketPrice": 5.45,
"lowestPrice": 3,
"lowestPriceWithShipping": 4.99,
"listingCount": 1,
"sellerCount": 1,
"imageCount": 1,
"imageUrl": "https://tcgplayer-cdn.tcgplayer.com/product/704860_in_1000x1000.jpg"
},
"marketPrices": [
{
"skuId": 123,
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"marketPrice": 5.45,
"lowSalePrice": 3,
"highSalePrice": 8,
"sampleSize": 25,
"calculatedAt": "2026-10-04T12:30:00.000Z"
}
],
"priceCoverage": {
"requestedSkuIds": [
123
],
"missingSkuIds": []
},
"marketHistory": {
"range": "quarter",
"variants": [
{
"skuId": 123,
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"averageDailyQuantitySold": 1,
"averageDailyTransactionCount": 1,
"totalQuantitySold": 25,
"totalTransactionCount": 25,
"buckets": [
{
"date": "2026-10-01",
"marketPrice": 5.45,
"quantitySold": 2,
"transactionCount": 2,
"lowSalePrice": 3,
"highSalePrice": 8,
"lowSalePriceWithShipping": 4.99,
"highSalePriceWithShipping": 9.99
}
]
}
]
},
"listings": {
"total": 1,
"offset": 0,
"limit": 10,
"sort": "price",
"offers": [
{
"listingId": 456,
"skuId": 123,
"seller": {
"id": "example-seller",
"name": "Example seller",
"ratingPercent": 99,
"sales": "100+",
"direct": false,
"verified": true
},
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"quantity": 2,
"itemPrice": 3,
"shippingPrice": 1.99,
"totalPrice": 4.99,
"currency": "USD",
"listingType": "standard"
}
]
},
"featuredListing": {
"listingId": 456,
"skuId": 123,
"seller": {
"id": "example-seller",
"name": "Example seller",
"ratingPercent": 99,
"sales": "100+",
"direct": false,
"verified": true
},
"condition": "Near Mint",
"variant": "Holofoil",
"language": "English",
"quantity": 2,
"itemPrice": 3,
"shippingPrice": 1.99,
"totalPrice": 4.99,
"currency": "USD",
"listingType": "standard"
},
"sections": {
"details": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"prices": {
"status": "stale",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": true,
"code": "UPSTREAM_HTTP_503",
"upstreamStatus": 503
},
"history": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"listings": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"spotlight": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
},
"image": {
"status": "ok",
"fetchedAt": "2026-10-04T12:30:00.000Z",
"cacheHit": false
}
}
}400 · INVALID_INPUT
{
"error": {
"code": "INVALID_INPUT",
"message": "Check route parameters or the JSON body."
}
}401 · INVALID_API_KEY
{
"error": {
"code": "INVALID_API_KEY",
"message": "Account-backed key is invalid, inactive, expired or revoked."
}
}401 · UNAUTHORIZED
{
"error": {
"code": "UNAUTHORIZED",
"message": "The optional local single-key credential is missing or invalid."
}
}404 · NOT_FOUND
{
"error": {
"code": "NOT_FOUND",
"message": "Unknown route."
}
}404 · IMAGE_NOT_AVAILABLE
{
"error": {
"code": "IMAGE_NOT_AVAILABLE",
"message": "No source image is available for this product."
}
}405 · METHOD_NOT_ALLOWED
{
"error": {
"code": "METHOD_NOT_ALLOWED",
"message": "Use the method published for this route."
}
}429 · RATE_LIMITED
{
"error": {
"code": "RATE_LIMITED",
"message": "Minute allowance exhausted; use Retry-After."
}
}429 · MONTHLY_QUOTA_EXCEEDED
{
"error": {
"code": "MONTHLY_QUOTA_EXCEEDED",
"message": "Monthly allowance exhausted; retry after the next UTC month."
}
}429 · AUTH_RATE_LIMITED
{
"error": {
"code": "AUTH_RATE_LIMITED",
"message": "Authentication admission limit reached."
}
}429 · DIAGNOSTIC_RATE_LIMITED
{
"error": {
"code": "DIAGNOSTIC_RATE_LIMITED",
"message": "Usage diagnostic rate limit reached."
}
}500 · INTERNAL_ERROR
{
"error": {
"code": "INTERNAL_ERROR",
"message": "Request failed; preserve x-request-id for support."
}
}502 · UPSTREAM_HTTP_status
{
"error": {
"code": "UPSTREAM_HTTP_503",
"message": "The source returned an error. Source 404 may map to API 404."
}
}502 · UPSTREAM_INVALID_RESPONSE
{
"error": {
"code": "UPSTREAM_INVALID_RESPONSE",
"message": "Source data failed response or identity validation."
}
}502 · UPSTREAM_RESPONSE_TOO_LARGE
{
"error": {
"code": "UPSTREAM_RESPONSE_TOO_LARGE",
"message": "Source or aggregate API response exceeds the byte limit."
}
}502 · UPSTREAM_NETWORK_ERROR
{
"error": {
"code": "UPSTREAM_NETWORK_ERROR",
"message": "Source transport failed."
}
}502 · UPSTREAM_CANCELED
{
"error": {
"code": "UPSTREAM_CANCELED",
"message": "Source work was canceled."
}
}503 · ACCESS_STORE_UNAVAILABLE
{
"error": {
"code": "ACCESS_STORE_UNAVAILABLE",
"message": "Account access store is unavailable or misconfigured."
}
}503 · USAGE_UNAVAILABLE
{
"error": {
"code": "USAGE_UNAVAILABLE",
"message": "Usage diagnostics require account-backed mode."
}
}503 · SERVICE_BUSY
{
"error": {
"code": "SERVICE_BUSY",
"message": "Service admission capacity exhausted; use Retry-After."
}
}503 · ACCESS_BUSY
{
"error": {
"code": "ACCESS_BUSY",
"message": "Database authorization capacity exhausted; use Retry-After."
}
}503 · UPSTREAM_BUSY
{
"error": {
"code": "UPSTREAM_BUSY",
"message": "Source queue is full; use Retry-After."
}
}503 · OCR_BUSY
{
"error": {
"code": "OCR_BUSY",
"message": "Photo recognition queue is full; use Retry-After."
}
}503 · OCR_UNAVAILABLE
{
"error": {
"code": "OCR_UNAVAILABLE",
"message": "Photo recognition is unavailable."
}
}504 · UPSTREAM_TIMEOUT
{
"error": {
"code": "UPSTREAM_TIMEOUT",
"message": "Source request exceeded its budget."
}
}504 · OCR_TIMEOUT
{
"error": {
"code": "OCR_TIMEOUT",
"message": "Photo recognition exceeded its processing budget."
}
}504 · REQUEST_DEADLINE_EXCEEDED
{
"error": {
"code": "REQUEST_DEADLINE_EXCEEDED",
"message": "Total request deadline exceeded."
}
}