/
v3.0.11Get access

subscribeToSearchGamesWithCompetition

This API powers the search functionality of a sports application. It creates a real-time subscription that filters the entire database based on a text string, returning matches where team names or competition names match the user's input. Data structure region (if includeRegion is true) -> competition -> game

Request parameters:

Name
DescriptionTypeValuesDefault
searchValue
The core parameter (e.g., "fulham"). This string is used to filter all available games.string--
language
Ensures the returned names match the user's interface language.string--
includeRegion
A toggle to decide if the data should include the geographic "Region" wrapper or just show competitions and games.booleantrue / false-
isInternalBetBuilderAvailable
Similar to the standard bet builder, this often refers to a proprietary or secondary system for creating custom parlays specifically within the search results.string--
isOlympicAvailable
Filter to include or exclude Olympic-specific event data.booleantrue / false-
isBetBuilderAvailable
If true, only returns matches that support builder bets.booleantrue / false-
isCloudAvailable
Internal flag for events with cloud-based featurebooleantrue / false-
isEsport
Flag to change data structure to correspond esport hierarchy. booleantrue / false-

Parameters marked with must be included in the request

Call example:

subscribeToSearchGamesWithCompetition({
  searchValue: 'fulham',
  includeRegion: true
})

Response examples:

{
  competition: {
    '538': {
      id: 538,
      name: 'Premier League',
      order: 1,
      game: {
        '29671352': {
          id: 29671352,
          start_ts: 1779026400,
          team2_name: 'Fulham',
          team1_name: 'Wolverhampton Wanderers'
        }
      }
    }
  }
}