⚽ Football Widgets Documentation

Embeddable football widgets for displaying live matches, league standings, and match schedules. All widgets support automatic timezone detection and customizable base URLs.

📋 Quick Start

Include the widget script in your HTML:

<script src="https://your-domain.com/hello-widget.iife.js" defer></script>

Changing Domain/Base URL

Use the base-url attribute to configure where links point to:

<league-widget league-id="10" base-url="https://betbrothers.football"></league-widget>
Note: All links in the widgets (matches, teams, leagues) will be prefixed with the base-url value. Leave it empty for relative URLs or provide your full domain for absolute URLs.

🎯 Available Widgets

1. League Matches Widget (<league-widget>)

Displays all matches for a specific league.

Parameter Type Required Description
league-id string Yes League identifier (see list below)
base-url string No Domain for links (e.g., "https://betbrothers.football")

2. League Standings Widget (<league-widget-standing>)

Displays league standings table with positions, points, and form.

Parameter Type Required Description
league-id string Yes League identifier (see list below)
base-url string No Domain for links

3. All Matches Widget (<all-matches-widget>)

Displays matches from all leagues with optional date picker and status filters.

Parameter Type Required Description
base-url string No Domain for links
date string No Specific date (YYYY-MM-DD format, e.g., "2025-12-18")
show-date-picker boolean No Show date navigation (true/false, default: false)
show-status-filters boolean No Show status filters (All/Live/Finished/Scheduled, default: false)

🏆 Popular League IDs

Use these league IDs with league-id parameter:

Premier League league-id="10"
La Liga league-id="8"
Serie A league-id="23"
Bundesliga league-id="17"
Ligue 1 league-id="4"
Champions League league-id="3"
Europa League league-id="5"
Eredivisie league-id="1"
💡 Tip: To find more league IDs, check your API response or contact support. The league ID corresponds to the id or league_id field from the leagues API.

📚 Widget Examples

Below are live examples of each widget. You can inspect the HTML to see the implementation.

1️⃣ League Matches Widget

Displays matches for Premier League:

<league-widget league-id="10" base-url="https://betbrothers.football"></league-widget>

2️⃣ League Standings Widget

Displays Premier League standings table:

<league-widget-standing league-id="10" base-url="https://betbrothers.football"></league-widget-standing>

3️⃣ All Matches Widget - Full Experience

With date picker and status filters:

<all-matches-widget show-date-picker="true" show-status-filters="true" base-url="https://betbrothers.football"> </all-matches-widget>

4️⃣ All Matches Widget - Fixed Date with Filters

Specific date with status filters:

<all-matches-widget date="2025-12-18" show-status-filters="true" base-url="https://betbrothers.football"> </all-matches-widget>

5️⃣ All Matches Widget - Simple

Just matches for a specific date:

<all-matches-widget date="2025-12-18" base-url="https://betbrothers.football"> </all-matches-widget>

🔧 Integration Tips

❓ Need Help?

For more league IDs, API documentation, or custom widget requirements, please contact the development team or check the API documentation.