Free iframe
How to publish the Free iframe widget.
The Free plan uses an iframe hosted by SoccersAPI. It is the fastest delivery mode and does not require loading the widget script on your page.
<iframe
src="https://embed.soccersapi.com/widgets/ls-soccersapi/free.html?uid=YOUR_UID&widget-id=livescore&locale=en&height=760"
style="width:100%;height:760px;min-height:760px;border:0;display:block;"
loading="lazy"
referrerpolicy="strict-origin-when-cross-origin"
data-soccersapi-widget="v2-free">
</iframe>Required values
| Parameter | Description |
|---|---|
uid | The user id that owns the saved widget configuration |
widget-id | The widget code, usually livescore |
locale | UI language, for example en or es |
height | Optional iframe height in pixels |
Before testing
- Save the widget configuration in the admin.
- Add the exact domain where the iframe will be embedded.
- Test from that domain, not from an unrelated preview URL.
If the iframe returns widget_not_found, the most common cause is copying the
code before saving the configuration.