# Sports — 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 football league standings, match results, player statistics, and upcoming fixtures from Sports.ru. Retrieve tournament tables, top scorers, detailed match information, and individual player profiles across major football leagues.

**Category:** Sports | **Website:** [sports.ru/](https://sports.ru/) | **Docs:** [parse.bot/marketplace/4b6fbd7a-4014-4ade-8bb0-9b530353e849/sports-ru-api](https://parse.bot/marketplace/4b6fbd7a-4014-4ade-8bb0-9b530353e849/sports-ru-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-sports-ru-api-4b6fbd7a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_league_matches

Returns recently completed or upcoming matches for a football tournament, grouped by date. Each match includes team info, scores (for completed), start time, and a base_url slug usable with get_match_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Match status filter. Accepted values: 'last' for past matches, 'future' for upcoming fixtures. |
| `tournament_id` | integer | Yes | ID of the tournament from get_tournament_list results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sports-ru-api-4b6fbd7a/get_league_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"<string>","tournament_id":"<integer>"}'
```

### get_league_standings

Returns the standings table for a specific football tournament. Each entry includes team place, points (score), matches played, and a color code indicating qualification zone. Results are grouped (single group for league formats).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tournament_id` | integer | Yes | ID of the tournament from get_tournament_list results (e.g., 31 for RPL, 52 for EPL, 49 for La Liga). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sports-ru-api-4b6fbd7a/get_league_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tournament_id":"<integer>"}'
```

### get_league_top_scorers

Returns top scorers, assist leaders, and yellow card leaders for a football tournament. Players are grouped by stat category (bombardiers, assists, yellow_cards) with player name, team, and stat values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tournament_id` | integer | Yes | ID of the tournament from get_tournament_list results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sports-ru-api-4b6fbd7a/get_league_top_scorers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tournament_id":"<integer>"}'
```

### get_match_details

Returns detailed match information including header info (teams, tournament, round), match statistics (possession, shots, cards), events (goals, cards with minute and player), and lineups (starting XI and substitutes). Match slug is obtained from get_league_matches base_url field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_slug` | string | Yes | Slug of the match from get_league_matches results base_url field (e.g., 'brighton-vs-mu', 'chelsea-vs-sunderland'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sports-ru-api-4b6fbd7a/get_match_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_slug":"<string>"}'
```

### get_player_profile

Returns a player's biographical data (born, citizenship, club, position, height/weight) and career statistics table by season (matches, goals, assists, cards, minutes). Player slug is obtained from tag_url fields in other endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_slug` | string | Yes | Slug of the player as used on sports.ru (e.g., 'erling-haland', 'bruno-fernandes', 'salah'). Found in tag_url field of player objects from other endpoints. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sports-ru-api-4b6fbd7a/get_player_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_slug":"<string>"}'
```

### get_tournament_list

Retrieves the list of football tournaments available on sports.ru. Only football (sport_id=208) returns data; other sport IDs yield empty results. Each tournament has an id usable in other endpoints and a localized Russian name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport_id` | integer | No | ID of the sport. Only Football (208) is supported and returns data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sports-ru-api-4b6fbd7a/get_tournament_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sport_id":"<integer>"}'
```