SoccersAPISoccersAPIWidgets V2

Search

How visitors find a team, competition, player or match from the Livescore toolbar, and how to turn search off.

Plans

The search icon in the Livescore toolbar opens a search dialog. Visitors type a name and open the team, competition, player or match they were looking for, without leaving your page.

What visitors can do

  • Type at least two characters. Results appear as they type.
  • Filter by kind: All, Teams, Leagues, Players or Matches.
  • Open a result. The dialog closes and the item opens the way your navigation mode says: in the window over the widget, in the widget itself, as a floating card or on your own page with Dynamic Pages. With None (no entity links), choosing a result only closes the dialog, so you may prefer to turn search off.
  • See more. The first 12 results show at once; Show more lists the rest, and Show less folds them again. The dialog scrolls on short screens and phones, so Show more is always reachable.

The best matches come first, and different kinds of results are mixed so that a team does not hide the competition of the same name. When two results share a name, the widget adds what tells them apart, such as the country or the competition. When the data has nothing to tell them apart, it shows the item's number (for example #99).

How it looks

The dialog follows your design: colours, fonts and corners. With the Carded layout preset, the results sit in one rounded group, and the hover highlight runs to its edges. In Arabic and Persian the rows read right to left.

The dialog opens inside the widget's area or over the whole page, as set by Modal anchor (see What happens when visitors click).

Turn search off

Untick Action · Search in Livescore navigation items to remove the icon from the toolbar. The other toolbar icons have their own switches in the same section.

Languages

Search works in every widget language. Names are matched as the SoccersAPI data spells them; in a language where the data has no translation for a name, search for it as the data shows it, usually in English. See Languages.

On this page