# Unibet (France) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time sports betting information from Unibet France, including live and upcoming events across multiple sports, detailed odds for all markets, and boosted odds promotions. Search competitions and events, compare betting odds across different formats, and stay updated on the latest sports fixtures and market opportunities.

**Category:** Sports | **Website:** [unibet.fr/](https://unibet.fr/) | **Docs:** [parse.bot/marketplace/9bc0a006-effb-425d-b5d4-a76420d4c31f/unibet-fr-api](https://parse.bot/marketplace/9bc0a006-effb-425d-b5d4-a76420d4c31f/unibet-fr-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_boosted_odds

Retrieve all currently active odds boosts and enhanced odds promotions. Returns events with boosted selections from the Unibet featured/promotions group. Empty array when no boosts are active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/get_boosted_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_competition_events

Retrieve upcoming and live events for a specific competition or league using its hierarchical path from get_competitions. Returns events with primary market odds. Empty array when no events are scheduled.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition_path` | string | Yes | Hierarchical competition path from get_competitions (e.g. 'football/england/premier_league', 'tennis/atp/wimbledon'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/get_competition_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"competition_path":"<string>"}'
```

### get_competitions

Retrieve all competitions and leagues available for a given sport. Returns a flat list of competition nodes (countries, leagues, tournaments) with their hierarchical path usable as input to get_competition_events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport_slug` | string | No | Sport term_key identifying which sport to list competitions for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/get_competitions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sport_slug":"<string>"}'
```

### get_event_odds

Retrieve all available betting markets and odds for a specific event by numeric ID. Returns the full array of bet offers (each with criterion, outcomes, and odds in Kambi integer format), event metadata, and pre-pack bet builder selections. A single event typically has 10-50+ bet offers across different market types.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Numeric event ID obtained from get_sport_events, get_live_events, search_events, or get_competition_events. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/get_event_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_live_events

Retrieve all currently live in-play events across all sports with primary market odds. Returns an empty array when no events are in play.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/get_live_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_odds_format

Convert a Kambi-format odds integer to decimal, American, and fractional representations. Pure local computation — does not call the upstream API. The Kambi integer divided by 1000 gives decimal odds (e.g. 3850 → 3.85).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `odds` | string | Yes | Kambi odds value as an integer string where dividing by 1000 gives decimal odds (e.g. '3850' for 3.85, '1500' for 1.50). |
| `target_format` | string | No | Target format for conversion. Accepted values: 'american', 'fractional'. Both formats are always returned regardless. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/get_odds_format \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"odds":"<string>","target_format":"<string>"}'
```

### get_sport_events

Retrieve all upcoming and live betting events for a given sport. Returns events with basic match info (name, start time, sport, competition group, state) and the primary market odds (1X2 or head-to-head). Single-page response ordered by start time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport_slug` | string | No | Sport term_key identifying which sport to list events for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/get_sport_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sport_slug":"<string>"}'
```

### get_sports

Retrieve the full catalogue of sports available on Unibet France. Each sport carries its term_key (usable as a sport_slug in other endpoints), current event count, and bet-offer count. The list is unordered and returned in a single page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/get_sports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_events

Search for sports events by keyword across all sports. Matches against event names and competition group names. Client-side filter over the full event catalogue — broad queries may return many results while very specific queries may return none.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against event names and competition group names. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-unibet-fr-api-9bc0a006/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```