Retrieve Bet Builder suggestions

A bet builder combines multiple selections from the same match into one bet (e.g. Match Winner + Over 2.5 Goals for the same fixture).
Results use the same layout as /insights: a list of fixtures, where each fixture contains a bet_builders[] array.
Results only ever include active, non-suspended bet builders — there's no way to include suspended or expired ones yet (a dedicated /bet-builders/archive endpoint, mirroring /insights/archive, is planned). Pagination is not implemented yet — a fixed internal result limit is applied for now.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
include
array of strings

Comma-separated list of modules to attach to each fixture. integration adds your platform's own event payload to every fixture in the response — see filter[integration]. Restricted to clients entitled to an integration.

include
Allowed:
string
^[a-z_]+:[^;]+(;[a-z_]+:[^;]+)*$

Selects which integration answers, and filters by your platform's own ids.
Segments are separated by ;, values inside a segment by ,.

providers:<name> picks the integration. Only ONE per request: if several are listed, the
first is honoured and the rest ignored. The one that answered is named by provider inside
each fixture's integration object. Omitted, it defaults to the integration your API key is
entitled to. Naming an integration you are not entitled to returns 403; naming one that
does not exist returns 400.

Supported here:

  • ext_event_ids — your event ids. A superseded id from a republished event still resolves.
  • ext_league_ids — your league ids. One of yours can map to several of ours (a regionalised
    division is one league to you and several groups to us); every one of them is returned.
  • ext_master_league_ids — prefer this over ext_league_ids: it survives your id rotations.
  • ext_country_ids — every league we hold under that country of yours.
  • ext_team_ids — the team on either side; ext_home_ids / ext_away_ids pin the side.
  • One of the three league keys, and one of the three team keys, per request.
  • mapped_only is not available here, for the same reason as /insights.

Send ids exactly as you receive them in the integration object, as strings — they are
64-bit values that a JSON number cannot hold without corruption.

An id we have no mapping for is not an error: you get an empty list, never an unfiltered
one. Coverage grows as we see more of your events.

A key this endpoint does not support returns 400 rather than being ignored, and so does
naming the same thing twice — league_id with a league key, or fixture_id with
ext_event_ids.

string

Comma-separated list of Model IDs to filter by. Example: model_id=1,2,3.

string
Defaults to en

Language code for the generated content. Alias lang is also accepted. Default: en.

integer

Restrict results to a specific single fixture.

string

Comma-separated list of League IDs.

integer
enum

Use 1 to filter only for events currently in-play, 0 for events not yet started. Omitted by default — no filtering on match state.

Allowed:
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json