Overview

Bet Discovery Widget

The Bet Discovery Widget is an iframe-embeddable component that displays betting trends, flows, and parlays. Partners embed it into their websites to surface Odditt content with full visual customization.

How It Works

  1. Embed - add an <iframe> pointing to your widget instance
  2. Configure - pass query parameters to control theme, filters, language, and scoped entities
  3. Customize - use the playground to design a theme preset, then deploy it to production
<iframe
  src="https://widget.example.com/?preset=brand_dark_v2&lang=en-US&leagueKey=nfl"
  width="100%"
  height="480"
  frameborder="0"
  style="border: none;"
></iframe>

Flow Types

The widget supports several flow types, automatically detected from the API response:

Flow TypeDescription
Fun FlowEmoji-driven narrative cards
Fact Flow (Base)Collapsed statistical summary
Fact Flow (Expanded)Expanded view with bar charts and split tabs

| Fun Flow Parlay | Multi-leg fun flow parlays |
| Fact Flow Parlay | Multi-leg fact flow parlays with expandable legs |
| Plain Flow Parlay | Multi-leg parlays without emojis |

Layout Modes

ModeDescription
CarouselHorizontal scrollable cards with dot navigation
FeedVertical stacked cards

Both modes are fully responsive and work inside iframes of any width.

Key Concepts

  • Playground - a shared instance where partners design and preview their themes in real time.
  • Presets - JSON files that capture all theme and layout settings. Created in the playground and loaded in production via URL.
  • Iframe Parameters - query parameters on the iframe src URL that control theme, language, filters, and entity scoping.
  • Widget Events - postMessage events sent to the parent page for bet clicks, pagination, filter changes, and more.

Next Steps

  • Playground - learn how to use the theme customization panel
  • Presets - understand how preset loading and hosting works
  • Iframe Parameters - full reference of all query parameters
  • Widget Events - handle user interactions from the embedded widget