SoccersAPISoccersAPIWidgets V2

Odds, affiliate links and banners

Earn from your widget with bookmaker odds, your affiliate buttons and bonus offers, 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, banners and your own bonus offers. 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.

On the Free and Starter plans

A Free widget is delivered by SoccersAPI, and SoccersAPI may show its own commercial content in it:

  • banners above and below the widget;
  • partner buttons in the livescore match rows (quiet, beside the odds when there are any) and in the header of the match window that opens over the widget;
  • when SoccersAPI enables them, odds from its own catalogue of bookmakers, in the livescore match rows and in the header of the match window. Each odds button links to the bookmaker with SoccersAPI's partner link, and the short line above the first competition (and under the match header) starts with Ad. The match window's Odds tab stays a Pro and Ultra feature.

SoccersAPI chooses and manages this content, including which bookmakers and which order, and which countries and devices see each item. You cannot add, change, hide or remove it, and the commercial settings of the configurator stay locked on Free: the bookmakers, links, odds and partner-button settings you saved, on Free or on another plan, are not used for it. While SoccersAPI has no bookmakers enabled for Free, Free widgets show no odds and do not load any.

Where SoccersAPI's partner buttons and odds appear follows the countries and devices SoccersAPI chooses for each bookmaker and partner link, and the compliance policy described below. There is no automatic block by country.

Once SoccersAPI has filled its inventory, the configurator preview of a Free widget can show this content too.

The visitor's responsible-gambling notice still applies, and so does a compliance policy agreed in your contract with SoccersAPI: it turns SoccersAPI's odds off exactly as it would turn off your own on Pro. Ad-server slots served by SoccersAPI ask for betting ads only in countries where SoccersAPI's rules allow them, and for non-betting ads when the visitor's country cannot be detected (details).

Starter shows no commercial content, neither from SoccersAPI nor from you. To show your own, move to Pro or Ultra.

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. The settings below are for Pro and Ultra; on Free, odds come only from SoccersAPI's own catalogue (see On the Free and Starter plans).

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.
Odds positionWhere the odds sit in the match header, the match window and floating cards: Left, Center or Right. Default keeps each one's usual place: centred on its own row under the stats line on a match page (and in a window expanded to full screen), at the end of the window header's third row. On a match page (and in an expanded window) the short responsible-gambling notice sits right under the odds, aligned with them; in the window at its usual size it opens the line under the header, lined up with the offer button (with the odds when there is no button).
Show bookmaker logoThe bookmaker's logo next to the odds. Bookmaker logo size sets it relative to the odds boxes.
Inline odds displayOutlined cells, Soft cells, Chips or Solid cells. Match rows and the match header use the same buttons.
Inline odds sizeExtra small, Small, Medium or Large, the same in rows and in the header.
Default market1x2, Over Under (goal line) or Asian Handicap.
Default bookmakerThe bookmaker whose odds are shown.
Use highest oddsShows, for each match, the bookmaker with the best prices for the whole market (the highest payout across its outcomes) instead of the default one. Goal line and Asian handicap only compare bookmakers on the same line.

Which bookmaker is shown, in this order:

  1. With Use highest odds on, the bookmaker with the best prices among up to ten bookmakers your catalogue and plan allow: the Default bookmaker and the next ones by priority.
  2. Otherwise the Default bookmaker.
  3. When the default one has no odds for a match, the next one by Fallback priority in the catalogue.

Your plan's bookmaker limit never leaves out the Default bookmaker: it always takes one of the places.

Match rows load the odds of the Default bookmaker and the next two by priority. With Use highest odds on, they load up to ten bookmakers your catalogue and plan allow: the Default bookmaker first, then the next ones by priority. The match header compares the same bookmakers. This makes each refresh of the list larger. Disable the bookmakers you do not need in the catalogue to keep it light.

For Over Under and Asian Handicap the line comes first, with the name of its market: O/U 2.5 (a quarter line such as 2.0/2.5 reads 2.25) and AH −0.5 (the home team's handicap). These labels follow the widget's language.

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.

Odds in the match rows and in the match header that link to your bookmaker open in a new tab with rel="sponsored noopener noreferrer": they are paid links, like your offers. They carry no Ad label.

Plans

Affiliate links are offers: Button offers next to the odds in the livescore match rows, in the match header, in the window that opens over the widget and in floating match cards, and Text link offers below the odds. Like odds, they are not added to team or competition fixture lists, head-to-head lists or favourites.

  • In the match rows a button is quiet: it looks like the odds, with your logo, your brand and a short label (the logo and the label on large phones and small tablets, the logo alone on most phones), and each match keeps one brand for the visit. An affiliate link shows its label, as wide as your longest label; on most phones a label longer than about six characters is shortened.
  • In the match header and the window it takes your brand colour.
  • The short responsible-gambling line above the first competition starts with Ad while the rows show buttons.

You add and manage them in Offers, as Button and Text link offers (Inline places). The configurator no longer has a Pro affiliate links section or a Bet link placement setting: the first time it opens a configuration that still has affiliate links, it turns them into offers, in the same places, with the same countries, devices and weights, and saving stores them as offers. See Your affiliate links are offers for how each setting carries over.

Why the preview shows a button you did not add

Until you add your own Button offer, the preview in the admin shows the default link of the base configuration (a Bet365 button); your own offer replaces it. The public playground shows a sample Button offer called Your partner instead, which never reaches your widget.

Use your full tracking URL, with every parameter your affiliate programme gives you. The widget opens the URL exactly as you type it, in a new tab, with rel="sponsored noopener".

Banners

Plans

There are eight banner slots, in four places:

  • Top banner and Bottom banner: above and below the widget;
  • Above the matches banner and In-feed banner (between leagues): inside the match list of the Livescore (and the all-in-one 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: Above the matches counts as a top slot and In-feed as a bottom slot. 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. The Modal bottom banner has no sticky option: it is always in view (see below). Above the matches and In-feed have none either: a banner stuck inside the match list would cover the matches.

In the match list

  • Above the matches banner sits between the toolbar and the first competition, lined up with the competition groups. If you also have an offer unit above the matches, both show: the banner first.

  • In-feed banner (between leagues) sits between competition groups:

    • After league: after which competition it first appears (default 3), counting from the top and leaving out the favourites group;
    • Repeat every (leagues): 0 (the default) shows it once; 5 shows it again five competitions later, and so on;
    • At most per list: how many times it can repeat in one match list (default 3).

    It never appears among favourites, with Match layout set to Grid, or right after the same competition as the offer list between leagues: then it moves one competition down. As the match list re-orders (a match goes live, for example), the banner stays after the same number of competitions.

A slot shows something only when it has a creative: an Image URL, or an iframe source or ad-server provider set through your configuration. Styling options on their own, such as Sticky, Background or Padding, don't make a slot appear.

Sticky banners

With Sticky top or Sticky bottom on, the banner stays in view while readers scroll:

  • Top banner and Bottom banner stay at the top or bottom of the screen while the widget is in view. If the toolbar is sticky too, it stays right below the top banner.
  • Entity top banner and Entity bottom banner do the same in match, team, competition and player views. They sit below or above the page banners when those are sticky too.
  • Modal top banner stays above the scrolling content of the window.
  • The Modal bottom banner doesn't need the option: it always sits in the window's footer, in view at the bottom of the window. That's why the configurator doesn't show Sticky bottom for this slot. When you also have an offer strip in the match window, both show in the footer: the strip above, the banner at the bottom edge.

While a banner is stuck, its Background shows behind it. If you left the background transparent, the widget's background colour is used instead, so the content scrolling underneath doesn't show through.

Sticky banners and your page's CSS

A sticky banner follows your page's scroll. If an element around the widget on your page sets overflow (hidden, auto or scroll) or a transform, the banner can only stick inside that element. Remove that rule from the widget's containers to let it follow the page.

Your own offers

Plans

Offers shows your own bonus offers inside the widget: an offer list above the matches (rows or a grid), a single offer card, a CTA banner, a strip in the match window, a card in the match's Prematch tab, an optional list between competitions, and buttons and text links next to the odds (your affiliate links). An offer placed in a banner zone takes the place of that banner, and the banner comes back when the offer has nothing for a visitor. The match window is the exception: its strip and the Modal bottom banner show together. Everything about offers, from formats to rotation, pinning and compliance, is on its own page: Your own offers.

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 Where-to-watch CTA: turn on Where-to-watch CTA in match, then fill in the texts and the link.

  • 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.
  • Where-to-watch CTA · 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

Odds and banners accept your own class names in Custom CSS classes (affiliate links no longer do: they are offer buttons now). Add a class there, then style it in your site's stylesheet:

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

Do not count on the widget's own stylesheet to style these names: class names of a CSS framework, such as Tailwind's mx-auto or mt-2, work only if your page loads that framework.

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. To style other parts of the widget, use its own class names: see CSS classes.

On this page