SoccersAPIWidgets V2

Free iframe

How to publish the Free iframe widget.

The Free plan uses an iframe hosted by SoccersAPI. It is the fastest way to add a livescore widget to an approved website.

Copy the generated block

Open Get code after publishing and copy the full Free iframe block generated by the configurator. You do not need to create the iframe manually.

Values you may see in the iframe

ValueDescription
uidThe user id that owns the published widget configuration
widget-idThe widget code, usually livescore
localeUI language, for example en or es
heightOptional iframe height in pixels. The configurator currently generates 1200 by default.

Before testing

Publish the widget configuration in the admin.

Add the exact domain where the iframe will be embedded.

Copy the Free iframe block from Get code.

Test from the approved domain, not from an unrelated preview URL.

Keep the iframe height large enough for the match list and match details. The default generated height is 1200px; reduce it only after testing your own page on desktop and mobile.

If the iframe returns widget_not_found, the most common cause is copying the code before publishing the configuration.

On this page