Get products

curl --request GET \
  --url https://api.snappy.com/public-api/v2/products \
  --header 'X-Api-Key: <api-key>'

{
  "results": [
    {
      "id": "string",
      "title": "string",
      "category": "string",
      "brand": {
        "id": "abCd57eFG0",
        "name": "Brand Name",
        "description": "Brand Description"
      },
      "coverImage": {
        "position": 1,
        "type": "image",
        "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
        "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
      },
      "options": {
        "takeYourPick": "Rainbow Bagel Making Kit",
        "color": "Black",
        "size": "S",
        "scent": "Lavender",
        "flavor": "Chocolate",
        "beverageType": "Coffee"
      },
      "tags": [
        {
          "id": "tag12345A",
          "name": "Tag Name",
          "color": "#000000",
          "position": 1
        }
      ],
      "variants": [
        {
          "id": "ab6789cd",
          "optionAttributes": {
            "takeYourPick": "Rainbow Bagel Making Kit",
            "color": "Black",
            "size": "S",
            "scent": "Lavender",
            "flavor": "Chocolate",
            "beverageType": "Coffee"
          },
          "brand": {
            "id": "abCd57eFG0",
            "name": "Brand Name",
            "description": "Brand Description"
          },
          "components": "string",
          "description": "Variant description",
          "features": "Variant features",
          "category": "Electronics / Audio / Headphones / Wireless Earbuds",
          "mediaItems": [
            {
              "position": 1,
              "type": "image",
              "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
              "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
            }
          ],
          "position": 0,
          "types": [
            "digital"
          ],
          "tags": [
            {
              "id": "tag12345A",
              "name": "Tag Name",
              "color": "#000000",
              "position": 1
            }
          ],
          "title": "Variant title",
          "information": {
            "including": "<ul><li>Cute puppy</li></ul>",
            "description": "<p>Cutest puppy in the world</p>",
            "features": "<ul><li>Floppy ears</li><li>Big eyes</li></ul>",
            "specifications": {
              "colorFamily": "Brown",
              "dimensions": "37in x17in 6in",
              "materials": "Cotton",
              "weight": "1.5 lbs"
            }
          },
          "notices": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
          },
          "pricing": {
            "US": {
              "cost": 100,
              "ddp": 10,
              "shipping": 5,
              "totalFee": 2,
              "totalTax": 7,
              "totalFinalCost": 109
            }
          },
          "supportedCountries": [
            {
              "countryCode": "US"
            },
            {
              "countryCode": "CA"
            },
            {
              "countryCode": "GB"
            },
            {
              "countryCode": "DE"
            },
            {
              "countryCode": "FR"
            }
          ]
        }
      ],
      "types": [
        "digital"
      ],
      "mediaItems": [
        {
          "position": 1,
          "type": "image",
          "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
          "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
        }
      ],
      "notices": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    }
  ]
}

Products & Variants

Get products

Use this endpoint to search for and retrieve a list of available products based on your specified criteria - including budget range, Collection, brand, tags, or free-text search on title and description.

Required fields:

minBudget query parameter - inclusive minimum budget (1-20,000)
maxBudget query parameter - inclusive maximum budget (1-20,000)

Filtering options:

collectionId - scope search to a specific Collection. When supplied, brandName, brands, tags, title, and description are ignored.
brandName - brand name match (used when collectionId is not provided)
brands - comma-separated list of brand IDs (used when collectionId is not provided)
tags - comma-separated list of tag IDs (used when collectionId is not provided)
title - product title match (used when collectionId is not provided)
description - product description match (used when collectionId is not provided)
country query parameter - ISO 3166-1 alpha-2 country code (default US)
companyId / accountId - scoping parameters
fields query parameter - comma-separated field projection. Valid values: mediaItems, tags, brand, optionAttributes, notices, pricing, supportedCountries, full
Request-Source header - source of the request (api_native, api_zapier, api_salesforce, api_ftp, api_make)

Pagination:

skip query parameter - number of records to skip (default 0)
limit query parameter - max records per page (1-100, default 100)

Please note:

collectionId is mutually exclusive with the other text/brand/tag filters. Supplying both will use collectionId and ignore the others.
Returns 422 when the supplied collectionId doesn’t exist or isn’t accessible.

Permissions

Requires: products:read

GET

products

Get products

curl --request GET \
  --url https://api.snappy.com/public-api/v2/products \
  --header 'X-Api-Key: <api-key>'

{
  "results": [
    {
      "id": "string",
      "title": "string",
      "category": "string",
      "brand": {
        "id": "abCd57eFG0",
        "name": "Brand Name",
        "description": "Brand Description"
      },
      "coverImage": {
        "position": 1,
        "type": "image",
        "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
        "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
      },
      "options": {
        "takeYourPick": "Rainbow Bagel Making Kit",
        "color": "Black",
        "size": "S",
        "scent": "Lavender",
        "flavor": "Chocolate",
        "beverageType": "Coffee"
      },
      "tags": [
        {
          "id": "tag12345A",
          "name": "Tag Name",
          "color": "#000000",
          "position": 1
        }
      ],
      "variants": [
        {
          "id": "ab6789cd",
          "optionAttributes": {
            "takeYourPick": "Rainbow Bagel Making Kit",
            "color": "Black",
            "size": "S",
            "scent": "Lavender",
            "flavor": "Chocolate",
            "beverageType": "Coffee"
          },
          "brand": {
            "id": "abCd57eFG0",
            "name": "Brand Name",
            "description": "Brand Description"
          },
          "components": "string",
          "description": "Variant description",
          "features": "Variant features",
          "category": "Electronics / Audio / Headphones / Wireless Earbuds",
          "mediaItems": [
            {
              "position": 1,
              "type": "image",
              "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
              "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
            }
          ],
          "position": 0,
          "types": [
            "digital"
          ],
          "tags": [
            {
              "id": "tag12345A",
              "name": "Tag Name",
              "color": "#000000",
              "position": 1
            }
          ],
          "title": "Variant title",
          "information": {
            "including": "<ul><li>Cute puppy</li></ul>",
            "description": "<p>Cutest puppy in the world</p>",
            "features": "<ul><li>Floppy ears</li><li>Big eyes</li></ul>",
            "specifications": {
              "colorFamily": "Brown",
              "dimensions": "37in x17in 6in",
              "materials": "Cotton",
              "weight": "1.5 lbs"
            }
          },
          "notices": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
          },
          "pricing": {
            "US": {
              "cost": 100,
              "ddp": 10,
              "shipping": 5,
              "totalFee": 2,
              "totalTax": 7,
              "totalFinalCost": 109
            }
          },
          "supportedCountries": [
            {
              "countryCode": "US"
            },
            {
              "countryCode": "CA"
            },
            {
              "countryCode": "GB"
            },
            {
              "countryCode": "DE"
            },
            {
              "countryCode": "FR"
            }
          ]
        }
      ],
      "types": [
        "digital"
      ],
      "mediaItems": [
        {
          "position": 1,
          "type": "image",
          "publicCloudinaryId": "bnxjv94tmzq1w8eplk73ua_picture-1.png",
          "src": "https://example.com/bnxjv94tmzq1w8eplk73ua_picture-1.png"
        }
      ],
      "notices": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    }
  ]
}

Authorizations

X-Api-Key

string

header

required

Company Level Authentication

Company level authentication provides access to all resources under your company, including accounts, campaigns, gifts, and recipients.

Getting Your API Key

Create an API Key: Use the POST /v2/authentication/apiKeys endpoint to generate a new API key
Set Expiration: Choose from 30, 60, 90, or 180 days (default: 90 days)
Optional mTLS: Enable mutual TLS for enhanced security
Name Your Key: Provide a descriptive name for easy identification

Using Your API Key

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

X-Api-Key: YOUR_24_CHARACTER_API_KEY

API Key Management

Maximum Keys: Up to 3 active API keys per company
Rotation: Delete old keys before creating new ones when at the limit
Security: Keys are hashed and cannot be retrieved after creation

Enhanced Security (mTLS)

For production environments, enable mutual TLS authentication:

Set enforceMtls: true when creating the API key
Contact support to obtain your client certificates
Use the mTLS endpoint: https://mtls-api.snappy.com/public-api

Headers

Request-Source

enum<string>

Source of the request

Available options:

api_native,

api_zapier,

api_salesforce,

api_ftp,

api_make

Example:

"api_native"

Query Parameters

minBudget

number

required

Minimum budget

Required range: 1 <= x <= 20000

Example:

1

maxBudget

number

required

Maximum budget

Required range: 1 <= x <= 20000

Example:

10000

collectionId

string

Collection ID. Used when "brandName", "brands", "tags", "title", "description" are not provided.

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

Example:

"abcdef12"

brandName

string

Brand name. Used when "collectionId" is not provided.

Example:

"abc123"

brands

string[]

List of product brand IDs. Used when "collectionId" is not provided.

Minimum array length: 1

Example:

["abc123"]

Response

Successful response

Response containing products.

results

object[]

required

The fetched products.

Show child attributes

Last modified on June 17, 2026

Products & Variants API (V2): Catalog Access for Gifting

Get product tags