Products
Orders
curl --request GET \
--url https://api.snappy.com/v3/products/{productId} \
--header 'X-Api-Key: <api-key>'{
"id": "a1b2c3d4e5",
"title": "Iphone 17 Pro Max",
"createdAt": "2026-01-15T10:30:00Z",
"media": [
{
"type": "image",
"src": "https://media.snappy.com/image/asset123?w=1000&h=1000&q=80&f=auto"
}
],
"category": {
"fullName": "gifts / electronics / iphones"
},
"catalog": "marketplace",
"types": [
"physical"
],
"variantsCount": 123,
"brand": {
"id": "621f9d4b1e675adcbc196159",
"name": "Apple",
"description": "Cute pet brand"
},
"tags": [
{
"id": "t1",
"name": "Popular"
}
],
"priceRange": {
"min": {
"amount": 10,
"currency": "usd"
},
"max": {
"amount": 10,
"currency": "usd"
}
}
}Get product (VariationGroup) by id
Retrieves a VariationGroup by its stable product id. This endpoint
returns product-level fields only; use
GET /v3/products/{productId}/variants to retrieve the full
paginated variants list.
Use include=brand,tags to request related entities, and use
fields=... to request priceRange, variantsCount, or full.
curl --request GET \
--url https://api.snappy.com/v3/products/{productId} \
--header 'X-Api-Key: <api-key>'{
"id": "a1b2c3d4e5",
"title": "Iphone 17 Pro Max",
"createdAt": "2026-01-15T10:30:00Z",
"media": [
{
"type": "image",
"src": "https://media.snappy.com/image/asset123?w=1000&h=1000&q=80&f=auto"
}
],
"category": {
"fullName": "gifts / electronics / iphones"
},
"catalog": "marketplace",
"types": [
"physical"
],
"variantsCount": 123,
"brand": {
"id": "621f9d4b1e675adcbc196159",
"name": "Apple",
"description": "Cute pet brand"
},
"tags": [
{
"id": "t1",
"name": "Popular"
}
],
"priceRange": {
"min": {
"amount": 10,
"currency": "usd"
},
"max": {
"amount": 10,
"currency": "usd"
}
}
}Documentation Index
Fetch the complete documentation index at: https://docs.snappy.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Partner API key. Finalized per partner integration agreement.
Headers
Optional account identifier for swag validation/filtering.
Path Parameters
Stable VariationGroup identifier.
Query Parameters
Minimum price filter. Inclusive.
Maximum price filter. Inclusive.
ISO 3166-1 alpha-2 country code (default US).
^[A-Z]{2}$Related entities to include (JSON:API include), comma-separated.
Supported values: brand, tags. Returned as full objects.
brand, tags Comma-separated list of computed/expanded fields for
GET /v3/products/{productId}.
priceRange, variantsCount, full Response
Product (VariationGroup).
Product (VariationGroup). Optional fields are returned only when
requested via include (related entities) or fields (computed/
expanded fields). Field availability depends on the calling endpoint
ā see the include / fields parameter descriptions.
Stable VariationGroup identifier.
"a1b2c3d4e5"
"Iphone 17 Pro Max"
"2026-01-15T10:30:00Z"
Product media items. Array order defines display order.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Product catalog. As a query value, omit filter[catalog] to search
both catalogs.
marketplace, swag "marketplace"
Product type. Used both as values of Product.types[] and as filter
values for filter[types].
physical, digital, giftCards, donations Returned only when fields includes variantsCount or full.
x >= 0123
Returned only when include=brand. Nullable when the product has no brand.
Show child attributes
Show child attributes
Returned only when include=tags.
Show child attributes
Show child attributes
Min/max pricing across the product's variants. Returned only when
fields includes priceRange or full.
Show child attributes
Show child attributes
Was this page helpful?