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