Overview
What Widgets V2 is, when to use it, and how it fits with SoccersAPI.
Widgets V2 is the ready-to-publish football widget product for SoccersAPI. It turns SoccersAPI football data into live score, match, league, team and player experiences that can be added to a website from the admin panel.
Use the API when you need raw football data for your own product. Use Widgets V2 when you want a finished football experience with saved configurations, approved domains, traffic limits and plan-based features.
Fast rule
Publish the configuration before copying the code. The public widget loads the active published version, not the unsaved preview open in your browser.
Delivery modes
Free iframe
The fastest way to test and publish a livescore widget on one approved domain.
Paid native embed
For Starter, Pro, Ultra and Custom plans when the widget should render directly inside your page.
Dynamic Pages
Optional per-domain add-on for indexable match, league, team and player pages.
The Free plan uses a hosted iframe. Paid plans can use the native Web Component embed, which renders the widget directly inside your page instead of inside the Free iframe. Dynamic Pages is a separate add-on for domains that need indexable entity URLs.
Core workflow
Create or open a Widgets V2 configuration in the SoccersAPI admin.
Select the widget type, language, layout, theme and Pro options.
Add the exact domain where the widget will be shown.
Choose which saved configuration that domain should load.
Save a named configuration if you want to reuse this setup later.
Publish the configuration so it becomes the active public version.
Copy the iframe or paid embed code and test it from the approved domain.
Important concepts
Saved configuration
A named setup stored in the admin. Use it as a reusable draft, layout version or seasonal setup.
Published configuration
The active setup that public widgets actually load after you publish.
Approved domain
A website host where the widget is allowed to run and can be mapped to a saved configuration.
Each approved domain can load the default/current configuration or a selected saved configuration. Read the configurator options page before planning multi-site launches.