LogoLogo
Quick StartFootball APIContactAPI 3.0
  • Welcome
  • Changelog
  • Getting Started
    • Get Started
    • Documentation for the documentation
  • Endpoint overview
    • Continents
      • GET All Continents
      • GET Continent by ID
    • Countries
      • GET All Countries
      • GET Country by ID
    • Leagues
      • GET All Leagues
      • GET League by ID
      • GET Leagues by Country ID
      • Search Leagues by Name
    • Seasons
      • GET All Seasons
      • GET Season by ID
    • Fixtures
      • GET Fixture by ID
      • GET Last Updated Fixtures
      • GET Fixtures by Date
      • GET Fixtures by Date Range
      • GET Fixtures by Date Range for Team
      • GET Fixtures by Multiple ID's
      • GET Deleted Fixtures
    • Statistics
    • Livescores
      • GET All Livescores
      • GET All In play Livescores
    • News API
      • GET All News
      • GET News For Upcoming Fixtures
      • GET News by Season ID
    • Commentaries
      • Commentaries by Fixture ID
    • Video Highlights
      • Get Video Highlights by Fixture ID
    • Head 2 Head
      • GET Head 2 Head by Team IDs
    • Standings
      • GET Standings by Season ID
      • GET LIVE Standings
      • GET Standings by Season ID and Round ID
      • GET Standings by Season and Date(time)
      • GET Standings Corrections by Season ID
    • Teams
      • GET Team by ID
      • GET Teams by Country ID
      • GET Teams by Season ID
      • Search Team by Name
      • GET Current Leagues by Team ID
      • Get All Leagues by Team ID
    • Players
      • GET Player by ID
      • GET Players by Country ID
      • Search Player by Name
    • Topscorers
      • GET Topscorers by Season ID
      • GET Topscorers Aggregated by Season ID
    • Rivals
      • GET Rivals by Team ID
    • Venues
      • GET Venue by ID
      • GET Venues by Season ID
    • Rounds
      • GET Rounds by Season ID
      • GET Round by ID
    • Odds
      • GET Odds by Fixture ID and Bookmaker ID
      • GET Odds by Fixture ID and Market ID
      • GET Odds by Fixture ID
      • GET Inplay Odds by Fixture ID
    • Coaches
      • GET Coach by ID
    • Stages
      • GET Stage by ID
      • GET Stages by Season ID
    • Bookmakers
      • GET All Bookmakers by Fixture ID
      • GET All Bookmakers
      • GET Bookmaker by ID
    • Markets
      • GET All Fixtures by Market ID
      • GET All Markets
      • GET Market by ID
    • Team Squads
      • GET Team Squad by Team and Season ID
    • TV Stations
      • GET TV Station by Fixture ID
    • Prediction API
      • GET Leagues and Performances
      • GET Probabilities
      • GET Probabilities by Fixture ID
      • GET Value Bets
      • GET Value Bet by Fixture ID
  • Tutorials
    • Introduction to our API
      • Make your first request
      • Set your time zone
      • Pagination
    • Enriching your response
      • Includes
      • Nested includes
    • Filtering, limiting & sorting
      • Filtering
      • Limiting
      • Sorting
    • Schedule, fixtures & livescores
      • Season schedule
      • Fixtures
      • Livescores
    • Statistics
      • Match statistics
      • Team statistics
      • Player statistics
      • Season statistics
    • League & topscorers standings
      • League standings
      • Topscorers standings
    • Odds & predictions
      • Odds
        • Odds by fixture, bookmaker and market id
        • FlatOdds
        • InplayOdds
      • Predictions
  • MySportmonks
    • How-to build a custom plan
    • ID Finder
  • How-to Guides
    • Get Started with our how-to guides
      • How-to build your API requests
    • Livescores & fixtures
      • How-to build a livescore website
      • How-to build a schedule page
    • Match & team pages
      • How-to build a match page with events and statistics
      • How-to build a match page with line-ups/formations
      • How-to build a team page with season stats and squads
    • How-to build standings and topscorer standings
      • League standings
      • Topscorer standings
    • Odds & predictions
      • How-to build a match page with odds
      • How-to build a betting odds portal
      • How-to use the predictions API
    • How-to build a fantasy game
    • Developer tools
      • How-to use Sportmonks' APIs in Postman
    • How-to keep your database in sync
    • World Cup 2022
    • EURO 2024
    • Football widgets
      • How-to set up football widgets in your web application
      • Configurations
      • Widgets overview
        • Livescore widget
        • International Cup widgets
  • API References
    • API reference guide
    • Data features
    • ID Finder
    • Code libraries
    • Demo response files
    • Statuses and definitions
    • API Rate limiting
    • Response codes
    • Meta description
  • General
  • Sportmonks
  • Plans & pricing
  • FAQ
  • Contact
Powered by GitBook
On this page
  • Step 1: Request widgets
  • Step 2: Set your domain
  • Step 3: Configure your widget
  • General settings
  • Step 4: Copy and paste embed code into your application

Was this helpful?

Export as PDF
  1. How-to Guides
  2. Football widgets

How-to set up football widgets in your web application

PreviousFootball widgetsNextConfigurations

Last updated 11 months ago

Was this helpful?

Hello and welcome to this how-to guide on how to get access to Sportmonks widgets and how to use them in your web application.

In this how-to guide we will look at the required steps for making use of our widgets. The steps are as followed:

  1. Request widgets

  2. Set your domain

  3. Configure your widget

  4. Copy and paste embed code into your application

Step 1: Request widgets

If you are interested in one or more of our widgets, you can request them at my.sportmonks.com. You will have to create an account if you don't have one already. In mySportmonks go to the My Widgets page under Football Widgets. This is the Widgets overview page where you can manage your widgets. From here you can request the widgets you are interested in!

When selecting widgets you can also choose if you want the Basic or the Advanced version of the widgets. In short, the advanced widgets have more data features and more options for customization. For example, the standings widget advanced offers Live standings and the Livescore Widget basic will not have access to the match center. Advanced widget users also have the option to configure colors used in the widget and use their own brand logo at the footer of the widgets.

Some widgets are based on the leagues you will have in your widget product. For example the Livescore Widget shows only fixtures of the leagues you have included in your widget product. If you select such a widget you will automatically go to the league selection page before you can finish your request.

Here you can search leagues based on country and/or name and (de)select the leagues you want access to in your widgets. When you are done, click on the Next button which leads to the overview page. On this page you have an overview of the selected widgets and leagues, so you can check once more your request before submitting it.

After submitting your request the sales team will contact you within 24 hours with a price proposal. After coming to an agreement about the price proposal you can subscribe at the My Widgets page to your new widget product.

You don't need an API subscription to request widgets. An only widgets subscription however doesn't give you access to the Football API.

Step 2: Set your domain

Make sure you have entered your domain correctly. Otherwise the widget cannot fetch and show the correct data.

Step 3: Configure your widget

  • Theme - Select a default theme (light/dark)

  • Theme switch - Option for showing or hiding theme switch (between dark and light mode) in widget

  • Font - Select the font used in the widgets

  • Colors (only advanced) - Select the colors used in the widgets

While you are configuring your widget, its live preview will be updated. You can also view the live preview in different screen sizes, such as mobile, tablet, desktop and responsive.

General settings

On the Widget Settings page the following configurations can be saved so they will be used across all your widgets:

  • Domain

  • Timezone

  • Colors (only advanced, also configurable per widget)

  • Brand (only advanced)

Step 4: Copy and paste embed code into your application

Once you configured your widget to your needs, you can get your generated embed code by clicking on the 'Get embed code' button on the Configurator page. The following overlay will be shown.

There are three code fragments you have to copy. The first fragment is the link to the widget's CSS. You will have to copy and paste this in the head of your web application page. The second fragment is the container in which the widget will be loaded. Place this in the body of a page where you want the widget to be shown. The third one is the JavaScript of the widget. Place this in at the end of of your body. So before the closing </body> tag.

Make sure you paste your widget into an application that runs on the domain you have set in the settings.

If you want to know which widgets we provide, check our widget overview by following the link below.

Go to:

After adding the widgets add-on to your subscription you will have to set your domain in the page or in the My Widgets page. The domain you enter here is the only domain from where you will be able to host our widgets. For example if you enter sportmonks-widgets.com as domain, the widget will only be authorized on that domain.

After setting your domain, you can visit the page. On this page you can view a live preview of widgets and configure them to your needs. The configurations you are able to do, depend on the type of widget and if you have the basic or the advanced variant of the widgets. The following customization options are available for every widget.

And that is it! You have successfully added a widget into your web application.

💯
🥇
https://my.sportmonks.com/widgets
Widgets Settings
Widgets Configurator
Widgets overview