Search products

200

A page of the product grid.

Response body: BrowseSearchResponse

success boolean required

Whether the operation completed as requested.

Constraints: allowed values: true

degraded boolean

Present and true while the marketplace is in degraded mode: prices and availability on browse surfaces may be briefly out of date, and are confirmed before purchase. Absent when the platform is healthy.

Constraints: allowed values: true

data object required

The operation or event payload.

Show child fieldsHide child fields

data.items BrowseProductSummary[] required

The records included in this page or batch.

Show child fieldsHide child fields

data.items[].productId integer required

See Canonical catalog in Core concepts.

data.items[].name string or null required

data.items[].set string or null required

The card set or expansion.

data.items[].category string or null required

The trading-card game category.

data.items[].rarity string or null required

The rarity assigned to the card printing.

data.items[].collectorNumber string or null required

data.items[].imageUrl string or null required

data.items[].isSealed boolean required

data.items[].fromPrice number required

Minimum offer price across sellers, in dollars as a decimal amount.

data.items[].sellerCount integer required

Count of distinct sellers offering this product.

data.items[].listingCount integer required

Exact count of browsable offers for this product under the active filters: one per seller-or-store and SKU-or-variant.

data.items[].disclosures ListingDisclosures or null required

Provenance, grading, and authenticity statements shown to the buyer.

Show child fieldsHide child fields

data.items[].disclosures.imageSource string required

Constraints: allowed values: catalog

data.items[].disclosures.conditionSource string required

Constraints: allowed values: seller_declared

data.items[].disclosures.authenticitySource string required

Constraints: allowed values: seller_attestation

data.items[].disclosures.snapcasterInspected boolean required

Constraints: allowed values: false

data.items[].disclosures.snapcasterGraded boolean required

Constraints: allowed values: false

data.items[].disclosures.snapcasterAuthenticated boolean required

Constraints: allowed values: false

data.items[].disclosures.gradingStandard string required

Constraints: allowed values: snapcaster-magic-v1, seller-declared-no-specialist-promise

data.items[].disclosures.declaredGrade string or null required

data.items[].disclosures.buyerProtection string required

Constraints: allowed values: magic-grade-and-authenticity, genuine-and-as-described

data.items[].fulfillmentObligation ListingFulfillmentObligation or null required

Show child fieldsHide child fields

data.items[].fulfillmentObligation.sku string required

The SKU that identifies the card variant.

Constraints: allowed values: exact

data.items[].fulfillmentObligation.printing string required

The card printing the seller must supply.

Constraints: allowed values: exact

data.items[].fulfillmentObligation.language string required

The language of the card printing.

Constraints: allowed values: exact

data.items[].fulfillmentObligation.finish string required

The physical finish or foil treatment of the card.

Constraints: allowed values: exact

data.items[].fulfillmentObligation.condition string required

The normalized condition assigned to the card.

Constraints: allowed values: declared-or-better

data.facets BrowseFacets required

Available filter values and their result counts.

Show child fieldsHide child fields

data.facets.category BrowseFacetValue[] required

The trading-card game category.

Show child fieldsHide child fields

data.facets.category[].value string required

data.facets.category[].count integer required

Number of products carrying this value under the current query.

data.facets.set BrowseFacetValue[] required

The card set or expansion.

Show child fieldsHide child fields

data.facets.set[].value string required

data.facets.set[].count integer required

Number of products carrying this value under the current query.

data.facets.rarity BrowseFacetValue[] required

The rarity assigned to the card printing.

Show child fieldsHide child fields

data.facets.rarity[].value string required

data.facets.rarity[].count integer required

Number of products carrying this value under the current query.

data.facets.seller BrowseSellerFacetValue[] required

One entry per seller with browsable listings matching the query. Each entry includes sellerCode for filtering and the store name for display, plus its count. Includes both express and manual stores. Other facets use { value, count }.

Show child fieldsHide child fields

data.facets.seller[].sellerCode string required

The store's public handle. Pass it as the sellerCode query parameter to filter results to this store.

data.facets.seller[].storeName string required

The store's display name. Use sellerCode as its identifier.

data.facets.seller[].count integer required

Number of the store’s listings under the current query.

data.facets.handoffStore array of object

Eligible Shopify handoff stores with matching offers. New responses always include this array, including when empty; optional for compatibility with older responses.

Show child fieldsHide child fields

data.facets.handoffStore[].storeSlug string required

The Shopify handoff store identity. Pass it as storeSlug, mutually exclusive with sellerCode.

data.facets.handoffStore[].storeName string required

data.facets.handoffStore[].count integer required

Matching offer-document count for this store, independent of pagination.

data.facets.condition BrowseFacetValue[] required

The normalized condition assigned to the card.

Show child fieldsHide child fields

data.facets.condition[].value string required

data.facets.condition[].count integer required

Number of products carrying this value under the current query.

data.facets.language BrowseFacetValue[] required

The language of the card printing.

Show child fieldsHide child fields

data.facets.language[].value string required

data.facets.language[].count integer required

Number of products carrying this value under the current query.

data.facets.finish BrowseFacetValue[] required

The physical finish or foil treatment of the card.

Show child fieldsHide child fields

data.facets.finish[].value string required

data.facets.finish[].count integer required

Number of products carrying this value under the current query.

data.facets.collectorNumber BrowseFacetValue[] required

Show child fieldsHide child fields

data.facets.collectorNumber[].value string required

data.facets.collectorNumber[].count integer required

Number of products carrying this value under the current query.

data.nextCursor string or null required

Opaque keyset cursor for the next page; null on the last page.