Guides
Markdown
Retrieving Products by Video

You can retrieve curated product sets linked to specific videos or video types using our /video endpoint group. This is ideal for powering context-aware product drops — for example, showing limited editions during highlights or on-screen merch during full-length broadcasts.

📘

See the API Reference for full schema details.


1. 📹 Get Products by Video ID or Slug

Returns all products linked to a specific video (e.g. a highlight reel, full game, or social clip).

Endpoints:

GET /video/:id

shell

GET /video/slug/:slug

shell

Response:

plain

2. 🧠 Get Products by Video Context Type

Returns products associated with a video content type, useful for powering different surfaces like short-form carousels vs full-game shop views.

Proposed Endpoint:

GET /video/context/:type

Supported types might include:

  • short-form
  • full-length
  • livestream
  • post-game

Example:

Return a smart selection of products optimized for short-form content views:

shell
💡

Note: This endpoint can be tailored to your content model. Contact our team to define your context types.


🛍️ Looking for Team, Player, or Tag-Based Filters?

The /video endpoint is optimized for content-driven product discovery. To browse the full range of product filtering options (including by team, player, lineup, tags, or custom POST queries) see:

Retrieving Product Catalogs →

This is the recommended starting point for powering storefronts, team pages, and merch collections.


👉 Next: Working with Carts →