Get featured collection products

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

import requests

url = "https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured"

headers = {"X-Api-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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",
      "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": 215,
                  "currency": "USD"
                },
                "priceBreakdown": {
                  "ddp": 10,
                  "shippingFee": 5,
                  "itemPrice": 200
                },
                "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."
                },
                "shippingRequired": true
              }
            }
          ]
        }
      ],
      "priceRange": {
        "min": {
          "amount": 215,
          "currency": "USD"
        },
        "max": {
          "amount": 215,
          "currency": "USD"
        }
      },
      "variantsCount": 12,
      "selectedOrFirstAvailableVariant": {
        "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": 215,
          "currency": "USD"
        },
        "priceBreakdown": {
          "ddp": 10,
          "shippingFee": 5,
          "itemPrice": 200
        },
        "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."
        },
        "shippingRequired": true
      }
    }
  ]
}

{
  "message": "Request validation failed.",
  "errorCode": "400_PBLC_001",
  "errors": [
    {
      "errorCode": "400_PBLC_001",
      "message": "filter[price][gte] must be less than or equal to filter[price][lte]",
      "path": "queryStringParameters.filter[price][gte]"
    }
  ]
}

{
  "message": "Product not found.",
  "errorCode": "404_PROD_001",
  "errors": [
    {
      "message": "Product with id 'q1w2e3r4t5' was not found",
      "path": "pathParameters.productId",
      "errorCode": "404_PROD_001"
    }
  ]
}

{
  "message": "Collection not found.",
  "errorCode": "404_PBLC_004"
}

Collections

Get featured collection products

Use this endpoint to retrieve the featured products of a collection for a budget range. Featured products are a Snappy-curated selection of the most popular items in the collection that fit the budget. We recommend displaying them at the top of your collection page, above the full product list from GET /v3/collections/{collectionId}/products.

Required parameters:

collectionId path parameter - the collection to retrieve featured products from.
filter[price][gte] - inclusive minimum budget (0 or more).
filter[price][lte] - inclusive maximum budget. Must be greater than or equal to filter[price][gte].

Optional parameters:

location - ISO 3166-1 alpha-2 country code (default US).
include - related entities to include, comma-separated. One or more of brand, tags.
fields - computed fields, comma-separated. One or more of selectedOrFirstAvailableVariant, priceRange, variantsCount.
seed - any string. The same seed returns the same selection for the same collection, budget, and location - for example, pass a recipient ID so each recipient sees a stable set of featured products.
Snappy-Account-Id header - optional account scoping.

Please note:

The response is not paginated. All featured products are returned in a single data array.
Each product has the same shape as in GET /v3/collections/{collectionId}/products, plus selectedOrFirstAvailableVariant when requested through fields.
Returns 400 when the price range is missing or invalid (e.g. filter[price][gte] greater than filter[price][lte]).
Returns 404 if the collection does not exist.

Permissions

Requires: products:read

GET

collections

{collectionId}

products

featured

Get featured collection products

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

import requests

url = "https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured"

headers = {"X-Api-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.snappy.com/public-api/v3/collections/{collectionId}/products/featured")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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",
      "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": 215,
                  "currency": "USD"
                },
                "priceBreakdown": {
                  "ddp": 10,
                  "shippingFee": 5,
                  "itemPrice": 200
                },
                "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."
                },
                "shippingRequired": true
              }
            }
          ]
        }
      ],
      "priceRange": {
        "min": {
          "amount": 215,
          "currency": "USD"
        },
        "max": {
          "amount": 215,
          "currency": "USD"
        }
      },
      "variantsCount": 12,
      "selectedOrFirstAvailableVariant": {
        "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": 215,
          "currency": "USD"
        },
        "priceBreakdown": {
          "ddp": 10,
          "shippingFee": 5,
          "itemPrice": 200
        },
        "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."
        },
        "shippingRequired": true
      }
    }
  ]
}

{
  "message": "Request validation failed.",
  "errorCode": "400_PBLC_001",
  "errors": [
    {
      "errorCode": "400_PBLC_001",
      "message": "filter[price][gte] must be less than or equal to filter[price][lte]",
      "path": "queryStringParameters.filter[price][gte]"
    }
  ]
}

{
  "message": "Product not found.",
  "errorCode": "404_PROD_001",
  "errors": [
    {
      "message": "Product with id 'q1w2e3r4t5' was not found",
      "path": "pathParameters.productId",
      "errorCode": "404_PROD_001"
    }
  ]
}

{
  "message": "Collection not found.",
  "errorCode": "404_PBLC_004"
}

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

Must be provided to retrieve swag products.

Minimum string length: 1

Example:

"acc123456"

Path Parameters

collectionId

string

required

Collection identifier.

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

Example:

"abcdef12"

Query Parameters

filter[price][gte]

number

required

Inclusive minimum budget for featured products.

Required range: x >= 0

Example:

70

filter[price][lte]

number

required

Inclusive maximum budget for featured products.

Required range: x >= 0

Example:

100

location

string

default:US

ISO 3166-1 alpha-2 country code.

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

Example:

"US"

include

enum<string>[]

Related entities to include.

Available options:

brand,

tags

Example:

["brand", "tags"]

fields

enum<string>[]

Computed or expanded product fields.

Computed or expanded fields for featured collection products.

Available options:

selectedOrFirstAvailableVariant,

priceRange,

variantsCount

Example:

[
  "selectedOrFirstAvailableVariant",
  "priceRange"
]

seed

string

Seed used to produce deterministic featured product selection.

Example:

"recipient-123"

Response

Featured products selected for the requested budget.

data

object[]

required

Featured products selected for the requested budget.

Show child attributes

Last modified on October 26, 2026

Authentication

Marketplace

Swag

Gifting

Administration

Get featured collection products

Required parameters:

Optional parameters:

Please note:

Permissions

Authorizations

Company Level Authentication

Headers

Path Parameters

Query Parameters

Response