Fetch Sports Promotional Feed

Request​

URI: /promoFeed

Example usage: https://{base_url}/promoFeed

The request is executed using the POST method.

This method allows fetching up-to-date data on leagues, events (matches), and pre-match markets from the Betby sports data feed.

Request parameters

Name	Type	Required	Description
brand	string	Yes	Partner's unique brand identifier assigned by Betby sports provider
lang	string	Yes	Language code in ISO 639 format, used to localize league, event, and market names

Example of a request

Request: /promoFeed

{
  "brand": "123",
  "lang": "en"
}

Response parameters

Name	Type	Required	Description
status	boolean	Yes	Indicates whether the request was successful Accepted values: true, false
data	object	Yes	Container for the sports feed data
data.items	array	Yes	Array of event objects, each representing a sports event with related data
data.items.eventId	string	Yes	Unique identifier of the event (match)
data.items.startTime	integer	Yes	Scheduled start time of the event in ISO 8601 format
data.items.league	object	Yes	Information about the league to which the event belongs
data.items.league.leagueId	string	Yes	Unique identifier of the league
data.items.league.leagueName	string	Yes	Name of the league (e.g., "Super Lig")
data.items.league.sportType	string	Yes	Type of sport associated with the league (e.g., "Soccer")
data.items.markets	array	Yes	List of pre-match markets (betting options) available for the event
data.items.markets.marketId	string	Yes	Unique identifier of the market
data.items.markets.range	object	Yes	Object containing available outcomes for the market: Key (for example: "1", "2", "3") — represents the outcome code "k" - odds for the outcome
data.items.competitors	array	Yes	List of competitors participating in the event (e.g., teams or players)
data.items.competitors.id	string	Yes	Unique identifier of the competitor (team/player)
data.items.competitors.name	string	Yes	Name of the competitor
data.items.competitors.sport_id	string	Yes	Identifier of the sport associated with the competitor
errors	object	No	Error data in case status = false
errors.error	string	No	Message with error description

Example of a successful response

Request: /promoFeed

{
  "status": true,
  "data": {
    "items": [
      {
        "eventId": "2545266352541798446",
        "startTime": "11-06-2025 15:00:15",
        "league": {
          "leagueId": "2344200571084476436",
          "leagueName": "Super Lig",
          "sportType": "FIFA"
        },
        "markets": [
          {
            "marketId": "11",
            "range": {
              "4": {
                "k": "1.4"
              },
              "5": {
                "k": "2.7"
              }
            }
          },
          {
            "marketId": "1",
            "range": {
              "1": {
                "k": "1.9"
              },
              "2": {
                "k": "3.3"
              },
              "3": {
                "k": "3.7"
              }
            }
          }
        ],
        "competitors": [
          {
            "id": "2346761346223312898",
            "name": "Trabzonspor",
            "sport_id": "300"
          },
          {
            "id": "2346275563678863372",
            "name": "Başakşehir FK",
            "sport_id": "300"
          }
        ]
      }
    ]
  }
}

Example of an unsuccessful response

Request: /promoFeed

{
    "status": false,
    "errors": {
        "error": "Brand ID is invalid!"
    }
}