snapcasterBrowseSearchResponse
Reusable BrowseSearchResponse schema.
Type: object
Fields
| Field | Type | Constraints | Meaning | Example |
|---|---|---|---|---|
successrequired | boolean | allowed values: true | Whether the operation completed as requested. | true (generated) |
degraded | boolean | allowed values: true | 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. | true (generated) |
datarequired | object | None | The operation or event payload. | {
"items": [
{
"productId": 0,
"name": "string",
"set": "string",
"category": "string",
"rarity": "string",
"collectorNumber": "string",
"imageUrl": "string",
"isSealed": true,
"fromPrice": 0,
"sellerCount": 0,
"disclosures": {
"imageSource": "catalog",
"conditionSource": "seller_declared",
"authenticitySource": "seller_attestation",
"snapcasterInspected": false,
"snapcasterGraded": false,
"snapcasterAuthenticated": false,
"gradingStandard": "snapcaster-magic-v1",
"declaredGrade": "string",
"buyerProtection": "magic-grade-and-authenticity"
},
"fulfillmentObligation": {
"sku": "exact",
"printing": "exact",
"language": "exact",
"finish": "exact",
"condition": "declared-or-better"
}
}
],
"facets": {
"category": [
{
"value": "string",
"count": 0
}
],
"set": [
{
"value": "string",
"count": 0
}
],
"rarity": [
{
"value": "string",
"count": 0
}
],
"seller": [
{
"sellerCode": "string",
"storeName": "string",
"count": 0
}
],
"condition": [
{
"value": "string",
"count": 0
}
],
"language": [
{
"value": "string",
"count": 0
}
],
"finish": [
{
"value": "string",
"count": 0
}
],
"collectorNumber": [
{
"value": "string",
"count": 0
}
]
},
"nextCursor": "string"
} (generated) |
data.itemsrequired | array of object | None | The records included in this page or batch. | [
{
"productId": 0,
"name": "string",
"set": "string",
"category": "string",
"rarity": "string",
"collectorNumber": "string",
"imageUrl": "string",
"isSealed": true,
"fromPrice": 0,
"sellerCount": 0,
"disclosures": {
"imageSource": "catalog",
"conditionSource": "seller_declared",
"authenticitySource": "seller_attestation",
"snapcasterInspected": false,
"snapcasterGraded": false,
"snapcasterAuthenticated": false,
"gradingStandard": "snapcaster-magic-v1",
"declaredGrade": "string",
"buyerProtection": "magic-grade-and-authenticity"
},
"fulfillmentObligation": {
"sku": "exact",
"printing": "exact",
"language": "exact",
"finish": "exact",
"condition": "declared-or-better"
}
}
] (generated) |
data.items[].productIdrequired | integer | None | Product Id for the surrounding items item record. | 0 (generated) |
data.items[].namerequired | string or null | None | The human-readable name of the resource. | string (generated) |
data.items[].setrequired | string or null | None | The card set or expansion. | string (generated) |
data.items[].categoryrequired | string or null | None | The trading-card game category. | string (generated) |
data.items[].rarityrequired | string or null | None | The rarity assigned to the card printing. | string (generated) |
data.items[].collectorNumberrequired | string or null | None | Collector Number for the surrounding items item record. | string (generated) |
data.items[].imageUrlrequired | string or null | None | Image Url for the surrounding items item record. | string (generated) |
data.items[].isSealedrequired | boolean | None | Is Sealed for the surrounding items item record. | true (generated) |
data.items[].fromPricerequired | integer | None | Minimum offer price across sellers, in integer minor units (cents). | 0 (generated) |
data.items[].sellerCountrequired | integer | None | Count of distinct Sellers offering this Product. | 0 (generated) |
data.items[].disclosuresrequired | object or null | None | Provenance, grading, and authenticity statements shown to the buyer. | {
"imageSource": "catalog",
"conditionSource": "seller_declared",
"authenticitySource": "seller_attestation",
"snapcasterInspected": false,
"snapcasterGraded": false,
"snapcasterAuthenticated": false,
"gradingStandard": "snapcaster-magic-v1",
"declaredGrade": "string",
"buyerProtection": "magic-grade-and-authenticity"
} (generated) |
data.items[].disclosures.imageSourcerequired | string | allowed values: catalog | Image Source for the surrounding disclosures record. | catalog (generated) |
data.items[].disclosures.conditionSourcerequired | string | allowed values: seller_declared | Condition Source for the surrounding disclosures record. | seller_declared (generated) |
data.items[].disclosures.authenticitySourcerequired | string | allowed values: seller_attestation | Authenticity Source for the surrounding disclosures record. | seller_attestation (generated) |
data.items[].disclosures.snapcasterInspectedrequired | boolean | allowed values: false | Snapcaster Inspected for the surrounding disclosures record. | false (generated) |
data.items[].disclosures.snapcasterGradedrequired | boolean | allowed values: false | Snapcaster Graded for the surrounding disclosures record. | false (generated) |
data.items[].disclosures.snapcasterAuthenticatedrequired | boolean | allowed values: false | Snapcaster Authenticated for the surrounding disclosures record. | false (generated) |
data.items[].disclosures.gradingStandardrequired | string | allowed values: snapcaster-magic-v1, seller-declared-no-specialist-promise | Grading Standard for the surrounding disclosures record. | snapcaster-magic-v1 (generated) |
data.items[].disclosures.declaredGraderequired | string or null | None | Declared Grade for the surrounding disclosures record. | string (generated) |
data.items[].disclosures.buyerProtectionrequired | string | allowed values: magic-grade-and-authenticity, genuine-and-as-described | Buyer Protection for the surrounding disclosures record. | magic-grade-and-authenticity (generated) |
data.items[].fulfillmentObligationrequired | object or null | None | Fulfillment Obligation for the surrounding items item record. | {
"sku": "exact",
"printing": "exact",
"language": "exact",
"finish": "exact",
"condition": "declared-or-better"
} (generated) |
data.items[].fulfillmentObligation.skurequired | string | allowed values: exact | The stock-keeping identity for the exact card offering. | exact (generated) |
data.items[].fulfillmentObligation.printingrequired | string | allowed values: exact | The exact card printing the Seller is obligated to supply. | exact (generated) |
data.items[].fulfillmentObligation.languagerequired | string | allowed values: exact | The language of the card printing. | exact (generated) |
data.items[].fulfillmentObligation.finishrequired | string | allowed values: exact | The physical finish or foil treatment of the card. | exact (generated) |
data.items[].fulfillmentObligation.conditionrequired | string | allowed values: declared-or-better | The normalized condition assigned to the card. | declared-or-better (generated) |
data.facetsrequired | object | None | Available filter values and their result counts. | {
"category": [
{
"value": "string",
"count": 0
}
],
"set": [
{
"value": "string",
"count": 0
}
],
"rarity": [
{
"value": "string",
"count": 0
}
],
"seller": [
{
"sellerCode": "string",
"storeName": "string",
"count": 0
}
],
"condition": [
{
"value": "string",
"count": 0
}
],
"language": [
{
"value": "string",
"count": 0
}
],
"finish": [
{
"value": "string",
"count": 0
}
],
"collectorNumber": [
{
"value": "string",
"count": 0
}
]
} (generated) |
data.facets.categoryrequired | array of object | None | The trading-card game category. | [
{
"value": "string",
"count": 0
}
] (generated) |
data.facets.category[].valuerequired | string | None | The value represented by this entry. | string (generated) |
data.facets.category[].countrequired | integer | None | Number of Products carrying this value under the current query. | 0 (generated) |
data.facets.setrequired | array of object | None | The card set or expansion. | [
{
"value": "string",
"count": 0
}
] (generated) |
data.facets.set[].valuerequired | string | None | The value represented by this entry. | string (generated) |
data.facets.set[].countrequired | integer | None | Number of Products carrying this value under the current query. | 0 (generated) |
data.facets.rarityrequired | array of object | None | The rarity assigned to the card printing. | [
{
"value": "string",
"count": 0
}
] (generated) |
data.facets.rarity[].valuerequired | string | None | The value represented by this entry. | string (generated) |
data.facets.rarity[].countrequired | integer | None | Number of Products carrying this value under the current query. | 0 (generated) |
data.facets.sellerrequired | array of object | None | Store facet: one entry per Seller with browsable Listings under the current query, carrying the public `sellerCode` to scope by and the store name to render. Both express (native) and manual (handoff) stores appear. Unlike the other facets a value needs two fields, so this one is not a plain { value, count }. | [
{
"sellerCode": "string",
"storeName": "string",
"count": 0
}
] (generated) |
data.facets.seller[].sellerCoderequired | string | None | The store’s public handle — feed it back as the `sellerCode` query param to scope. | string (generated) |
data.facets.seller[].storeNamerequired | string | None | The store display name to render; not a handle/slug. | string (generated) |
data.facets.seller[].countrequired | integer | None | Number of the store’s Listings under the current query. | 0 (generated) |
data.facets.conditionrequired | array of object | None | The normalized condition assigned to the card. | [
{
"value": "string",
"count": 0
}
] (generated) |
data.facets.condition[].valuerequired | string | None | The value represented by this entry. | string (generated) |
data.facets.condition[].countrequired | integer | None | Number of Products carrying this value under the current query. | 0 (generated) |
data.facets.languagerequired | array of object | None | The language of the card printing. | [
{
"value": "string",
"count": 0
}
] (generated) |
data.facets.language[].valuerequired | string | None | The value represented by this entry. | string (generated) |
data.facets.language[].countrequired | integer | None | Number of Products carrying this value under the current query. | 0 (generated) |
data.facets.finishrequired | array of object | None | The physical finish or foil treatment of the card. | [
{
"value": "string",
"count": 0
}
] (generated) |
data.facets.finish[].valuerequired | string | None | The value represented by this entry. | string (generated) |
data.facets.finish[].countrequired | integer | None | Number of Products carrying this value under the current query. | 0 (generated) |
data.facets.collectorNumberrequired | array of object | None | Collector Number for the surrounding facets record. | [
{
"value": "string",
"count": 0
}
] (generated) |
data.facets.collectorNumber[].valuerequired | string | None | The value represented by this entry. | string (generated) |
data.facets.collectorNumber[].countrequired | integer | None | Number of Products carrying this value under the current query. | 0 (generated) |
data.nextCursorrequired | string or null | None | Opaque keyset cursor for the next page; null on the last page. | string (generated) |
Examples
{ "success": true, "data": { "items": [ { "productId": 0, "name": "string", "set": "string", "category": "string", "rarity": "string", "collectorNumber": "string", "imageUrl": "string", "isSealed": true, "fromPrice": 0, "sellerCount": 0, "disclosures": { "imageSource": "catalog", "conditionSource": "seller_declared", "authenticitySource": "seller_attestation", "snapcasterInspected": false, "snapcasterGraded": false, "snapcasterAuthenticated": false, "gradingStandard": "snapcaster-magic-v1", "declaredGrade": "string", "buyerProtection": "magic-grade-and-authenticity" }, "fulfillmentObligation": { "sku": "exact", "printing": "exact", "language": "exact", "finish": "exact", "condition": "declared-or-better" } } ], "facets": { "category": [ { "value": "string", "count": 0 } ], "set": [ { "value": "string", "count": 0 } ], "rarity": [ { "value": "string", "count": 0 } ], "seller": [ { "sellerCode": "string", "storeName": "string", "count": 0 } ], "condition": [ { "value": "string", "count": 0 } ], "language": [ { "value": "string", "count": 0 } ], "finish": [ { "value": "string", "count": 0 } ], "collectorNumber": [ { "value": "string", "count": 0 } ] }, "nextCursor": "string" }}