Skip to main content
GET
/
v3
/
base-products
List base products
curl --request GET \
  --url https://api.snappy.com/v3/base-products \
  --header 'X-Api-Key: <api-key>'
{
  "data": [
    {
      "id": "bp_a1b2c3",
      "title": "<string>",
      "media": [
        {
          "type": "image",
          "src": "https://media.snappy.com/image/asset123?w=1000&h=1000&q=80&f=auto"
        }
      ],
      "category": {
        "fullName": "gifts / electronics / iphones"
      },
      "types": [
        "physical"
      ],
      "brand": {
        "id": "621f9d4b1e675adcbc196159",
        "name": "Apple",
        "description": "Cute pet brand"
      }
    }
  ],
  "links": {
    "first": "/v3/collections/abc/products?page[size]=100",
    "next": "/v3/collections/abc/products?page[cursor]=cursor_abc123&page[size]=100",
    "prev": "<string>"
  }
}

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

X-Api-Key
string
header
required

Partner API key. Finalized per partner integration agreement.

Query Parameters

brandIds
string[]

Exact filter by brand id(s). Comma-separated.

fields
string[]

Optional base-product/base-variant field expansions. Comma-separated.

page[number]
integer
default:1

1-indexed page number for page-number paginated endpoints.

Required range: x >= 1
page[size]
integer
default:40

Number of base products per page (max 100, default 40).

Required range: 1 <= x <= 100

Response

Paginated list of base products.

Paginated base product list response.

data
object[]
required

Top-level JSON:API-style pagination links for paginated list responses. first is always present. next is null on the final page. prev is null on the first page (and on cursor-paginated endpoints where backward navigation is not supported).

Last modified on May 15, 2026