SoccersAPISoccersAPIWidgets V2

Odds, affiliate links and banners

Earn from your widget with bookmaker odds, your own affiliate buttons and banner slots, and put your logo on it.

On Pro and Ultra the widget can carry your own commercial content: bookmaker odds with your tracking links, affiliate buttons and banners. You set all of it in the right-hand column of the configurator.

Where betting content must not appear, Compliance turns it off, whatever is set on this page.

Bookmaker odds

Plans

Odds appear in the livescore match rows, in the match header and in the Match widget's Odds tab. They are not shown in league or team fixture lists, head-to-head lists or favourites.

SettingWhat it does
Bookmaker odds enabledMain switch. Off hides odds in match rows, in the match header and the visitors' Odds switch.
Inline odds in match rowOdds in each livescore row.
Odds in match headerOdds in the match header. Off by default.
Show bookmaker logoThe bookmaker's logo next to the odds. Bookmaker logo size sets it relative to the odds boxes.
Inline odds displayText only, Outlined cells, Soft cells, Chips or Solid cells.
Inline odds sizeExtra small, Small, Medium or Large.
Default market1x2, Over Under or Asian Handicap.
Default bookmakerThe bookmaker whose odds are shown.
Use highest oddsShows, for each match, the bookmaker paying the most instead of the default one. It only makes a difference when the data has several bookmakers for a match, which is usual in the Odds tab but not in the livescore rows.

Which bookmaker is shown: the one with the highest odds when Use highest odds is on, otherwise the Default bookmaker, and when that one has no odds for a match, the next one by Fallback priority in the catalogue.

Visitors can also hide odds themselves with the Odds switch in the livescore toolbar. You can remove that switch with Odds switch in Livescore navigation items.

Bookmaker catalogue

Plans

Bookmaker catalog & priority lists 39 bookmakers. For each one you can set:

FieldWhat it does
EnabledMakes the bookmaker available to the widget.
URLYour tracking link for that bookmaker. Needs custom bookmaker links in your plan.
Fallback priority0 to 10. Decides which bookmaker is used when your default one has no odds for a match.
Restricted countriesTwo-letter codes, separated by commas. Visitors from those countries do not see this bookmaker.
Restricted devicesmobile or desktop, to hide the bookmaker on one kind of device.

Your plan sets how many bookmakers can be active at the same time.

Plans

Affiliate links are buttons or text links with your own tracking URL, shown in the livescore match rows and in the match header. Like odds, they are not added to team or competition fixture lists, head-to-head lists or favourites.

SettingWhat it does
Affiliate links enabledMain switch.
Show in match rows / Show in match headerWhere the links appear.
Rotate linksCycles through your enabled links. Rotation interval (s) sets the pace, 5 to 600 seconds.
Advance on clickMoves to the next link each time a visitor clicks one.
Start strategyWhich link comes first: Session Hash (the same link for a visitor during their visit), First or Random.

The editor has 20 link slots. Your plan sets how many of them can be active; slots above your limit show a lock. Each slot has these fields:

FieldWhat it does
Enabled, Label, Description, URLThe link itself. A slot without a URL is skipped.
TypeButton or Text.
Button styleSolid, Gradient, Outline, Soft, Neutral or Text link.
SizeXS, Small, Medium or Large.
Content and IconText, Icon + text or Icon only, and the icon to use.
ColorA theme colour such as primary, or a hex value.
TargetBlank (new tab) or Self (same tab).
Weight1 to 100. A higher weight is picked more often when links rotate.
Target countries / Restricted countriesShow the link only to, or hide it from, visitors in those countries. Two-letter codes, separated by commas.
Restricted devicesmobile or desktop.
Custom CSS classesYour own class names, so your site's stylesheet can restyle the link.

Bet link placement (in Data & match content) decides where the button sits in a match row: With the odds (after the odds, or in their place when a match has none), Under the status or Own line.

Why the preview shows a Bet365 button

Until you enable a slot with its URL, the configurator preview shows the default link of the base configuration. The slots you enable replace it.

Use your full tracking URL, with every parameter your affiliate programme gives you. The widget opens the URL exactly as you type it.

Banners

Plans

There are six banner slots, in three places:

  • Top banner and Bottom banner: above and below the widget;
  • Entity top banner and Entity bottom banner: inside match, team, competition and player views;
  • Modal top banner and Modal bottom banner: inside the window that opens over the widget.

Top and bottom slots are unlocked separately, so a plan can include one kind and not the other. Each slot has Enabled, Image URL, Click URL, Alt text, Size (width in pixels), Target, Rel, Tracking pixel, Background, Padding, a sticky option (Sticky top or Sticky bottom) and Custom CSS classes.

Plans

Pro branding adds your logo to the widget: Custom logo URL, a second URL for dark mode (Custom logo URL · dark), Custom logo size (20 to 300 px) and Custom logo position (Left, Center or Right).

You edit these settings with Match, League, Leagues, Team or Player selected in the configurator, but the logo also appears above the Livescore and inside the window that opens over it. Turning off Show all entity headers hides it.

Plans

When a match is on TV, a where-to-watch call to action in the match's TV tab (and in its Prematch tab) sends visitors to your streaming or affiliate partners. You set it up in Pro streaming; for now it works on Ultra, and it is being enabled on Pro.

  • Title and Description can use {home}, {away}, {broadcaster} and {country}, for example How to watch {home} vs {away}.
  • Up to three short steps, a player-style image with its own button, and a disclaimer.
  • Pro streaming · channel catalog stores your link for each channel. When a match's broadcast data lists that channel, the widget uses your link automatically.

Without a destination link and a known broadcaster, only the text is shown.

Custom CSS classes

Affiliate links, odds and banners accept your own class names in Custom CSS classes. Add a class there, then style it in your site's stylesheet:

.my-cta { border-radius: 999px; }

This works with the script installation of paid plans, where the widget is part of your page. It does not work with the Free iframe, because your stylesheet cannot reach inside an iframe.

On this page