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 Betflow 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 Type	Description
Fun Flow	Emoji-driven narrative cards
Fact Flow (Base)	Collapsed statistical summary
Fact Flow (Expanded)	Expanded view with bar charts and split tabs
Fact Flow (Multi-Trend)	Multi-trend statistics display
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

Mode	Description
Carousel	Horizontal scrollable cards with dot navigation
Feed	Vertical 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