Betting content and responsible gambling
The notice every widget shows, and how to hide odds, bookmakers, affiliate links and banners where you must.
Widgets can show betting content: odds, bookmaker logos and links, your affiliate buttons and commercial banners. The Compliance section, in the right-hand column of the configurator, controls where that content may appear and what notice is shown with it.
These settings help you meet your obligations. They are not legal advice, and you remain responsible for what your site shows in each country.
What every widget shows
On every plan, the widget shows a responsible-gambling notice under its content, written for the visitor's country: a short warning such as 18+ Gioco Responsabile in Italy, a link to a support service and a help line. Where no country text exists, the default is Gamble responsibly. 18+ only. with a link to Gambling Therapy, shown in the widget's language. A country text is always shown in that country's language, whatever the widget's language.
The same notice also appears in a short, one-line form right where the betting content is, so visitors see it without scrolling to the end of a long list:
- above the first competition of the list, when its match rows show odds or betting links;
- right under the odds or the betting link in the match header and in the window that opens over the widget;
- under the odds row of a floating card (a floating card that only shows the bookmaker button in its header has no short line).
The short line shows the warning and the link to the support service. It only appears where odds or betting links are shown, and it follows Show compliance notice. On Free, where the odds come from SoccersAPI's own catalogue and link to the bookmaker, the line starts with Ad; where no notice text applies (the United States and Turkey), it says Ad alone. See Monetization.
The Ticker widget is the one widget without the notice under it: its score bar of matches and its events log show no odds or betting links. A match it opens in the window shows the short notice next to the odds, and a match opened in place of the bar (In-widget content) shows the full notice under it. The Livescore keeps its notice with the live ticker and the events log turned on.
Countries with their own notice text: Australia, Austria, Belgium, Brazil, Bulgaria, Canada (with regional texts for Ontario and Alberta), France, Germany, Greece, Ireland, Italy, Monaco, the Netherlands, Portugal, Spain and the United Kingdom, and in Argentina the city and the province of Buenos Aires. For visitors from the United States and Turkey no notice is shown unless you write your own. Visitors from every other country (the rest of Argentina included), and visitors whose country cannot be detected, see the default notice, translated into the 22 languages of the widget.
The country texts only change the notice. No country turns off betting content by itself: that happens only when you, or your contract, declare it.
SoccersAPI's own ad slots
Ad-server slots served by SoccersAPI (for example on the Free plan, see Monetization) wait until the widget has tried to detect the visitor's country, then ask for an ad once. They ask for betting ads only when the country is known and its rules allow them. When the country cannot be detected, or the country rules cannot be read, they ask for non-betting ads. This only concerns those ad slots. SoccersAPI's partner buttons and odds on Free, and your own banners, links and offers, are not blocked by country: they follow the countries and devices chosen for each item, by SoccersAPI or by you, and a compliance policy when one is declared (below).
Your own policy
Plans
On Pro and Ultra you can declare a policy. On other plans the section is visible but read-only, and the country notice above still applies. The configurator preview follows the section as you change it.
Policy
| Setting | What it does |
|---|---|
| Compliance mode | Clean (no betting content) turns off all betting content everywhere: odds, bookmaker links, affiliate links and commercial banners. Standard keeps betting content and applies the settings below. Configurations saved with the former Country or Custom modes keep working: they always behaved like Standard. |
| Site jurisdiction | The country whose rules govern your site, as a two-letter code such as IT. The notice then follows that country for every visitor. If the jurisdiction is also in Restricted visitor countries, betting content is off for everyone. |
| Restricted visitor countries | Two-letter codes, separated by commas, such as IT, ES. Visitors from those countries get no betting content. |
| Block betting when country is unknown | On by default. If the visitor's country cannot be detected, betting content stays off. It only acts when you have set a site jurisdiction or restricted countries. |
Betting surfaces
Turn off one kind of content for every visitor: Disable all odds, Disable bookmaker links, Disable affiliate links, Disable commercial banners and Hide bookmaker logos.
Notice text
Show compliance notice turns the notice on or off, under the widget and next to odds. Short notice next to odds (on by default) turns off only the one-line form next to odds; the notice under the widget stays. The other fields appear while the notice is on and replace the country text with your own: Responsible-gambling text, Resource link label, Resource URL, Help text, Help URL and Additional compliance text. If you leave all of them empty, the notice keeps the country text. Once you fill in any of them, the notice shows only what you entered: fields you leave empty stay empty. The short line uses your responsible-gambling text (or, without it, your additional text, or your help text) and your resource link.
How the rules combine
- The strictest rule wins. Once any rule turns something off, no other setting can turn it back on. A country restriction cannot be undone by a switch, and a switch cannot restore content your contract excludes.
- A policy agreed in your contract always applies. SoccersAPI can mark a policy as enforced; the configurator cannot relax it.
- Your plan still applies. Compliance only removes content. It never shows odds, links or banners that your plan does not include.
- SoccersAPI's content on Free follows the same rules. Its banners, partner buttons and odds disappear wherever your contract's policy, a clean profile or a restricted country would remove yours.
Two examples
An Italian site that must not show betting content. Set Compliance mode to Clean. Odds, bookmakers, affiliate links and banners disappear for every visitor. The livescore, results and statistics stay.
An international site that must hide betting from visitors in Italy and
Spain. Set Restricted visitor countries to IT, ES and keep Block
betting when country is unknown on. Visitors elsewhere still see odds; visitors
from those countries, and visitors whose country cannot be detected, do not.
When the country cannot be detected
The widget detects the visitor's country from their connection, using public geolocation services, and remembers it for a few hours. Detection can fail, for example when a browser extension blocks those requests. While the country is not known yet, a site with a country policy shows no betting content.
- Without a country policy, betting content is shown as usual.
- With a site jurisdiction or restricted countries, betting content stays off for that visitor, unless you turn off Block betting when country is unknown.
Each affiliate link (a Button or Text link offer) can also have its own countries, and each bookmaker its own Restricted countries. See Monetization. Disable affiliate links also hides the gambling buttons and text links of your offers in the match rows, the match header, below the odds and in floating cards, whatever Apply my compliance policy to offers says.
Your offers
Your own offers have their own targeting (countries, devices, unknown country, end date). With Apply my compliance policy to offers on, the policy on this page also hides your gambling offers wherever it switches off affiliate links or commercial banners. See Your markets, your rules.
Your own offers
Show your own bonus offers and partner buttons inside the widget, as a list, a grid, a card, a strip, a CTA banner, a button next to the odds or a text link, rotate them, and pin them while readers scroll.
Domains, configurations and saving
Approve the sites where your widget runs, decide which design each one loads, and understand when changes go live.