Overview
What Widgets V2 is, when to use it, and how it fits with SoccersAPI.
Widgets V2 is the embeddable UI layer for SoccersAPI. It turns SoccersAPI football data into live score, match, league, team and player experiences that can be published without building every screen from scratch.
Use the API when you need raw football data for your own product. Use Widgets V2 when you want ready-made football UI that still follows saved configurations, domain validation, traffic limits and plan feature flags.
Delivery modes
| Mode | Available on | Best for |
|---|---|---|
| Free iframe | Free | Fast installation on one approved domain |
| Native web component | Starter, Pro, Ultra, Custom | SEO-ready pages and deeper site integration |
The iframe is hosted from embed.soccersapi.com. The native web component is
loaded from static.soccersapi.com/widgets/ls-soccersapi/ls-soccersapi.umd.js
and renders directly inside your DOM.
Core workflow
- Create or open a Widgets V2 configuration in the SoccersAPI admin.
- Select the widget type and configure the UI.
- Add the allowed production domain.
- Save the configuration.
- Copy the iframe or native code.
- Test the published page from the exact approved domain.
Do not copy the embed before saving the configuration. The public runtime loads
the saved configuration by uid and widget-id.