Get product recommendations

curl --request GET \
  --url https://api.snappy.com/public-api/v3/products/{productId}/recommendations \
  --header 'X-Api-Key: <api-key>'

{
  "data": [
    {
      "id": "655277e68e0719000d6c3fd5",
      "title": "NFL 25-Layer StadiumView Wall Art",
      "createdAt": "2026-05-11T10:53:01.026Z",
      "media": [
        {
          "type": "image",
          "src": "https://media.snappy.com/image/o1xc17wfbda6cl91hm0r6_picture-1.jpg?w=1000&h=1000&q=80&f=auto"
        }
      ],
      "category": {
        "fullName": "Fan Merchandise / NFL / NFL Memorabilia / Autographed Helmets"
      },
      "catalog": "marketplace",
      "type": "physical",
      "brand": {
        "id": "6511b55142c420000d083a55",
        "name": "YouTheFan",
        "description": "Officially licensed NFL fan merchandise."
      },
      "tags": [
        {
          "id": "tag12345",
          "name": "Sustainable"
        }
      ],
      "options": [
        {
          "name": "nfl_team",
          "displayName": "Team",
          "displayType": "image",
          "values": [
            {
              "displayName": "Denver Broncos",
              "value": "Denver Broncos",
              "firstSelectableVariant": {
                "id": "FB6bgFV4lf",
                "title": "NFL 25-Layer StadiumView Wall Art",
                "selectedOptions": {
                  "nfl_team": "Denver Broncos"
                },
                "taxable": true,
                "media": [
                  {
                    "type": "image",
                    "src": "https://media.snappy.com/image/o1xc17wfbda6cl91hm0r6_picture-1.jpg?w=1000&h=1000&q=80&f=auto"
                  }
                ],
                "personalization": {
                  "isPersonalized": true,
                  "personalizationTemplateFields": [
                    "firstName",
                    "lastName",
                    "department"
                  ]
                },
                "productId": "655277e68e0719000d6c3fd5",
                "price": {
                  "amount": 244.99,
                  "currency": "USD"
                },
                "priceBreakdown": {
                  "ddp": 0,
                  "shippingFee": 0,
                  "itemPrice": 244.99
                },
                "partnerPrice": {
                  "amount": 45.7,
                  "currency": "usd"
                },
                "descriptionHtml": "<p>The 25-Layer StadiumViews 3D Wall Art</p>",
                "details": {
                  "includes": "<p>Set of 4 glasses (12oz each)</p>",
                  "features": "<ul><li>Feature</li></ul>",
                  "specifications": {
                    "material": "lead-free glass",
                    "capacity": "12oz",
                    "dimensions": "4.5' tall"
                  },
                  "notices": {
                    "prop65Warning": "Warning text"
                  }
                },
                "brand": {
                  "id": "6511b55142c420000d083a55",
                  "name": "YouTheFan",
                  "description": "Officially licensed NFL fan merchandise."
                }
              }
            }
          ]
        }
      ],
      "priceRange": {
        "min": {
          "amount": 244.99,
          "currency": "USD"
        },
        "max": {
          "amount": 244.99,
          "currency": "USD"
        }
      },
      "variantsCount": 9
    }
  ]
}

Products

Get product recommendations

Use this endpoint to retrieve products related to a given source product.

Optional parameters

filter[price][gte] / filter[price][lte] - restrict recommendations to a price range. Both bounds must be supplied together.
collectionId - restrict recommendations to products in a given collection.
page[limit] - control the size of the returned set (0-20).
include=brand,tags - return related entities in each recommended product.

Please note

At most page[limit] products are returned.
This endpoint is not paginated.
Returns 404 (404_PROD_001) when the source productId does not exist.
Returns 422 (422_PBLC_003) when collectionId references a collection that does not exist or is not accessible.

Permissions

Requires: products:read

GET

products

{productId}

recommendations

Get product recommendations

curl --request GET \
  --url https://api.snappy.com/public-api/v3/products/{productId}/recommendations \
  --header 'X-Api-Key: <api-key>'

{
  "data": [
    {
      "id": "655277e68e0719000d6c3fd5",
      "title": "NFL 25-Layer StadiumView Wall Art",
      "createdAt": "2026-05-11T10:53:01.026Z",
      "media": [
        {
          "type": "image",
          "src": "https://media.snappy.com/image/o1xc17wfbda6cl91hm0r6_picture-1.jpg?w=1000&h=1000&q=80&f=auto"
        }
      ],
      "category": {
        "fullName": "Fan Merchandise / NFL / NFL Memorabilia / Autographed Helmets"
      },
      "catalog": "marketplace",
      "type": "physical",
      "brand": {
        "id": "6511b55142c420000d083a55",
        "name": "YouTheFan",
        "description": "Officially licensed NFL fan merchandise."
      },
      "tags": [
        {
          "id": "tag12345",
          "name": "Sustainable"
        }
      ],
      "options": [
        {
          "name": "nfl_team",
          "displayName": "Team",
          "displayType": "image",
          "values": [
            {
              "displayName": "Denver Broncos",
              "value": "Denver Broncos",
              "firstSelectableVariant": {
                "id": "FB6bgFV4lf",
                "title": "NFL 25-Layer StadiumView Wall Art",
                "selectedOptions": {
                  "nfl_team": "Denver Broncos"
                },
                "taxable": true,
                "media": [
                  {
                    "type": "image",
                    "src": "https://media.snappy.com/image/o1xc17wfbda6cl91hm0r6_picture-1.jpg?w=1000&h=1000&q=80&f=auto"
                  }
                ],
                "personalization": {
                  "isPersonalized": true,
                  "personalizationTemplateFields": [
                    "firstName",
                    "lastName",
                    "department"
                  ]
                },
                "productId": "655277e68e0719000d6c3fd5",
                "price": {
                  "amount": 244.99,
                  "currency": "USD"
                },
                "priceBreakdown": {
                  "ddp": 0,
                  "shippingFee": 0,
                  "itemPrice": 244.99
                },
                "partnerPrice": {
                  "amount": 45.7,
                  "currency": "usd"
                },
                "descriptionHtml": "<p>The 25-Layer StadiumViews 3D Wall Art</p>",
                "details": {
                  "includes": "<p>Set of 4 glasses (12oz each)</p>",
                  "features": "<ul><li>Feature</li></ul>",
                  "specifications": {
                    "material": "lead-free glass",
                    "capacity": "12oz",
                    "dimensions": "4.5' tall"
                  },
                  "notices": {
                    "prop65Warning": "Warning text"
                  }
                },
                "brand": {
                  "id": "6511b55142c420000d083a55",
                  "name": "YouTheFan",
                  "description": "Officially licensed NFL fan merchandise."
                }
              }
            }
          ]
        }
      ],
      "priceRange": {
        "min": {
          "amount": 244.99,
          "currency": "USD"
        },
        "max": {
          "amount": 244.99,
          "currency": "USD"
        }
      },
      "variantsCount": 9
    }
  ]
}

Authorizations

X-Api-Key

string

header

required

Company Level Authentication

Include your API key in the X-Api-Key header for every request:

X-Api-Key: YOUR_API_KEY

Headers

snappy-account-id

string

Optional account identifier for swag validation/filtering.

Example:

"acc123456"

snappy-company-id

string

Optional company identifier for swag validation/filtering.

Example:

"cmp123456"

Path Parameters

productId

string

required

Stable identifier of the source product.

Pattern: ^[A-Za-z0-9]{8,}$

Example:

"655277e68e0719000d6c3fd5"

Query Parameters

location

string

required

ISO 3166-1 alpha-2 country code used to scope pricing and availability.

Pattern: ^[A-Z]{2}$

Example:

"US"

filter[price][gte]

number | null

Inclusive minimum price. Must be sent together with filter[price][lte].

Required range: x >= 0

Example:

10

filter[price][lte]

number | null

Inclusive maximum price. Must be sent together with filter[price][gte].

Required range: x >= 0

Example:

50

collectionId

string

Restrict recommendations to products belonging to the given collection.

Example:

"6527bb3567f414000c15d2c7"

page[limit]

integer | null

default:10

Maximum number of recommendations to return.

Required range: 0 <= x <= 20

Example:

10

include

enum<string>[]

Comma-separated related entities to expand in each recommended product.

Related entities to include.

Available options:

brand,

tags

Example:

["brand", "tags"]

Authorizations

Company Level Authentication

Headers

Path Parameters

Query Parameters

Response