The /products endpoint lets you dynamically fetch product data across players, teams, tags, and content types. Itโs the foundation for powering storefronts, merch collections, and contextual product placementsโlike overlays during live video. You can retrieve products using:
GETโ simple queries via URL parametersPOSTโ structured filters in a JSON request body for advanced use cases
๐All product objects include key details like name, price, tags, player/team associations and availability. See the API Reference for the full schema.
๐ฏ Vertical-Specific Parameters
Below are some examples, for the full list see the API Reference.
๐ Sports Clients:
| Parameter | Description |
|---|---|
player | Filter by one or more player slugs |
team | Filter by team slug |
tags | Custom sports metadata (e.g. jersey_type:association) |
products_per | Limit results per player |
๐ฅป Fashion & Lifestyle Clients:
| Parameter | Description |
|---|---|
category | e.g. dresses, shoes, outerwear |
tags | Custom fashion metadata (e.g. style:minimalist, y2k) |
season | e.g. spring, fall |
trending | Boolean flag for curated drops |
๐ฌAvailable filters depend on your vertical (e.g. Sports, Fashion, Creator). Some parameters may only be enabled for specific client types. Want to configure vertical-specific filters? Contact our team to tailor your catalog setup.
๐ Endpoints
Fetch products via GET or POST across all catalog types.
GET /productsโ Lightweight filtering via query parametersPOST /productsโ Structured filter object with full flexibility
๐งญ Common Query Examples (Sports Vertical)
These apply to sports + entertainment clients. Other verticals may vary.
1. Get Default Product List (e.g. Top Sellers)
shell
2. Filter by Team
shell
3. Starting Lineup (5 players, 3 products each)
shell
4. Filter by Tag (e.g. jersey type)
shell
๐ Using POST for Advanced Filters
Use the POST /products endpoint for complex filters, nested tags, or precise pagination:
shell
Request Example (Sports):
json
Request Example (Fashion):
json
๐บLooking to link products to video content? See Retrieving Products by Video
