> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/uof/custombet-cb/api/pre-built-bet-recommendation.md).

# Pre-Built Bet Recommendation

The Pre-Built Recommendation API delivers ready-to-place Bet Builder combinations directly to sportsbook users, helping operators promote Bet Builder, increasing engagement, turnover, and conversion.

{% hint style="info" %}
**We have observed a 40+% increase in bet volume after using the pre-built bet recommendation.**
{% endhint %}

With a single API endpoint, operators can surface relevant pre-built bets across Home Pages, Sport Pages, Competition Pages, and Event Pages.

Recommendations are generated from multiple recommendation engines and returned through a unified API, allowing operators to access the most relevant pre-built bets for each user and touchpoint.

### 2. Recommendation Types <a href="#id-2.-recommendation-types" id="id-2.-recommendation-types"></a>

The Pre-Built Recommendation API supports three recommendation types.

| Recommendation Type       | Value                                                                                                                                                                                                                                                                         | Availability                                                             | How to Request                                                                                                                                                                           | Supported Sports                                                                                                                                                                                                                                                            |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Popular Pre-Builts        | AI-generated combinations based on aggregated betting activity and ticket data from the operator's sportsbook. Designed to surface the most popular and engaging combinations among the operator's audience.                                                                  | Available for Custom Bet clients that share ticket data with Sportradar. | <p>Provide an event ID and/or filters to receive the most relevant popular recommendations.</p><p>Check the API request section for more details.</p>                                    | <p>Available across most sports and events supported by Custom Bet.</p><p>Check <a href="https://sportradar.atlassian.net/wiki/spaces/betbuilders/pages/325681323/Custom+Bet+API+-+Pre-built+Recommendation#3.-Supported-Sports-%26-Markets">here</a> for more details.</p> |
| Personalized Pre-Builts   | AI-generated combinations tailored to an individual user's historical betting behaviour and preferences. Designed to maximize relevance and engagement for each user.                                                                                                         | Available for Custom Bet clients that share ticket data with Sportradar. | <p>Provide a user ID to receive personalized recommendations. Event IDs and filters can be combined to further refine results.</p><p>Check the API request section for more details.</p> | <p>Available across most sports and events supported by Custom Bet.</p><p>Check <a href="https://sportradar.atlassian.net/wiki/spaces/betbuilders/pages/325681323/Custom+Bet+API+-+Pre-built+Recommendation#3.-Supported-Sports-%26-Markets">here</a> for more details.</p> |
| Trader-Curated Pre-Builts | <p>Recommendations created and maintained by Sportradar traders. These combinations focus on storytelling, engagement, and special betting experiences.</p><p>Also, you can get special pre-built types such as Player H2H, Player vs Team , Multi-match recommendations.</p> | Available for Custom Bet clients. No ticket data required.               | <p>Request recommendations using event IDs and/or supported filters.</p><p>Check the API request section for more details.</p>                                                           | Currently available for Soccer World Cup pre-match events (2026). Additional sports and competitions will be added in future releases.                                                                                                                                      |

### 3. Best Practices <a href="#id-3.-best-practices" id="id-3.-best-practices"></a>

We recommend displaying Pre-Built Recommendations across multiple sportsbook touchpoints. A horizontal carousel is the recommended UI pattern.&#x20;

<figure><img src="https://1868790214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1KlIQPveu0EGYCTI8DL1%2Fuploads%2Fq9x5B9C4J8kV46v4YyeU%2FScreenshot%202026-08-10%20at%2011.21.15.png?alt=media&amp;token=f2214856-6553-4005-856e-dc8d8443587d" alt=""><figcaption></figcaption></figure>

| Placement      | Objective                                    | Recommended Pre-Builts                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Home Page**  | Maximize awareness and drive discovery       | <ul><li>Popular Pre-Builts for upcoming events within the next 48 hours to create urgency and engagement.</li><li>Personalized Pre-Builts to immediately present relevant recommendations when a user enters the sportsbook.</li><li>Popular Pre-Builts from the most important sport in your market (e.g., Cricket in India, Soccer in Europe) to showcase highly engaging betting opportunities.</li></ul> |
| **Sport Page** | Drive sport-level engagement and exploration | <ul><li>Popular Pre-Builts for upcoming matches in major competitions within the selected sport.</li><li>Multi-Match Pre-Builts covering multiple events from the same tournament or competition.</li><li>Trader-Curated Pre-Builts highlighting key stories, players, and tournament narratives.</li></ul>                                                                                                  |
| **Match Page** | Maximize conversion and bet placement        | <ul><li>Popular player-focused Pre-Builts with proven betting appeal and high engagement.• Personalized Pre-Builts tailored to the user's betting preferences and history.• Trader-Curated formats such as Player vs Team and Player Head-to-Head recommendations to create differentiated betting experiences.</li></ul>                                                                                    |

Try out now on our [Demo Page](https://sports-demo.vaix.ai/?test_user_id=demo_user_football_epl#home)

### 4. Supported Sports & Markets <a href="#id-4.-supported-sports-and-markets" id="id-4.-supported-sports-and-markets"></a>

We support all key Sports for both Pre-match and Live events.

| **Sport**         | **Pre-match** | **Live**    |
| ----------------- | ------------- | ----------- |
| Soccer            | YES           | YES         |
| Basketball        | YES           | YES         |
| Tennis            | YES           | YES         |
| Ice Hockey        | YES           | YES         |
| Baseball          | YES           | Coming soon |
| American Football | YES           | Coming soon |
| Volleyball        | Coming soon   | n/a         |
| Cricket           | YES           | Coming soon |
| MMA               | YES           | Coming soon |

Note: Trader-Curated Pre-Builts are currently available only for Soccer Pre-match - World Cup events. Please stay tuned as we will expand more in the future.

### 5. Access & Integration Journey <a href="#id-5.-access-and-integration-journey" id="id-5.-access-and-integration-journey"></a>

{% stepper %}
{% step %}

### Activate Access

**Popular & Personalized Pre-Builts**

To access Popular and Personalized recommendations:

1. Contact your Sportradar Sales Representative to activate the Pre-Built Recommendation package.
2. Sportradar completes the required setup and ticket-data configuration.
3. Once setup is completed, Popular and Personalized recommendations become available automatically.

**Trader-Curated Pre-Builts**

No activation is required. Trader-Curated recommendations are immediately available through the API.
{% endstep %}

{% step %}

### Integrate the Recommendation Endpoint

Integrate the Pre-Built Recommendation API endpoint. The same endpoint provides access to all recommendation types.
{% endstep %}

{% step %}

### Test and Go Live

Once integration is completed, recommendations can be tested and released into production.
{% endstep %}
{% endstepper %}

### 6. Pre-Built Odds Handling <a href="#id-6.-pre-built-odds-handling" id="id-6.-pre-built-odds-handling"></a>

For clients that are using harmonization - When you call our pre-built API endpoint, the odds provided via the endpoint are using the Custom Bet Ladder you selected in CTRL. When the punter adds the pre-built into the bet slip, you can then call our API using the harmonization approach to get the final harmonized odds, which is the ultimate odds you would like to offer to clients.

To keep the pre-built odds updated please follow the guide below:

* When a user adds a recommendation to the bet slip, always perform a final calculate request before placement
* For more enhanced user experience, you can update the displayed pre-built odds by calling our Pre-built API whenever there is an odds change message for that match.

### 7. FAQ <a href="#id-11.-faq" id="id-11.-faq"></a>

#### 1. Is the endpoint available for all sports? <a href="#is-the-endpoint-available-for-all-sports" id="is-the-endpoint-available-for-all-sports"></a>

The endpoint is available for most of the sports we offer now, and more coming soon. Please check the 4th sections for details.

#### 2. Can I receive recommendations without a user ID? <a href="#can-i-receive-recommendations-without-a-user-id" id="can-i-receive-recommendations-without-a-user-id"></a>

Yes. Use user=0 to receive the most popular recommendations.

#### 3. Can I receive recommendations without an event ID? <a href="#can-i-receive-recommendations-without-an-event-id" id="can-i-receive-recommendations-without-an-event-id"></a>

Yes. The API can return recommendations across relevant events using filters and ranking logic.

#### 4. Will odds always be returned? <a href="#will-odds-always-be-returned" id="will-odds-always-be-returned"></a>

Yes. Every recommendation contains combined odds and fair probability. However, the odds are non-harmonized odds, so we recommend you to recall the calculation API if you want to show the harmonized odds price, otherwise you can recall the calculation API when a user place the pre-built to their betslip to get the lastest odds price.

#### 5. What data powers Popular Pre-Builts? <a href="#what-data-powers-popular-pre-builts" id="what-data-powers-popular-pre-builts"></a>

Our AI model generates recommendations primarily based on the ticket data you share with us, ensuring that suggestions are aligned with the preference from your whole user base.

#### 6. What powers Trader-Curated Pre-Builts? <a href="#what-powers-trader-curated-pre-builts" id="what-powers-trader-curated-pre-builts"></a>

Recommendations are created and maintained by Sportradar traders for major campaigns, tournaments and special events.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sportradar.com/uof/custombet-cb/api/pre-built-bet-recommendation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.