# Russian Football Union — 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 comprehensive Russian Football Union data including live tournament matches, detailed statistics, standings, and national team rosters all in one place. Stay updated with the latest news and match information across all major Russian football competitions.

**Category:** Sports | **Website:** [rfs.ru/](https://rfs.ru/) | **Docs:** [parse.bot/marketplace/b230c53a-ad39-4b1c-a357-60d55e4e2507/rfs-ru-api](https://parse.bot/marketplace/b230c53a-ad39-4b1c-a357-60d55e4e2507/rfs-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-rfs-ru-api-b230c53a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_match_detail

Get detailed match information including lineups (HTML), goals, punishments, timeline, text broadcast, and structured translation metadata with scores and video URL. Requires a match_id obtainable from get_tournament_matches. Returns the full match protocol with HTML sections for rendering. Translation metadata may be null for matches that have not started.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Match ID obtained from get_tournament_matches results (e.g. '57062'). |
| `slug` | string | No | Tournament slug identifier. Currently 'cup' (FONBET Russian Cup) is the primary slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rfs-ru-api-b230c53a/get_match_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<string>","slug":"<string>"}'
```

### get_national_team_squad

Get the squad list for a Russian national team. Returns player names and profile URLs. Available team types include the men's senior team and youth teams.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_type` | string | No | Team type identifier. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rfs-ru-api-b230c53a/get_national_team_squad \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_type":"<string>"}'
```

### get_news_list

Get the 10 most recent news articles from the RFS website. Returns article titles and full URLs. Articles cover match reports, press conferences, team announcements, and tournament updates.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rfs-ru-api-b230c53a/get_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_tournament_list

Retrieve all tournaments listed on the RFS website. Returns tournament names, slugs (used as identifiers for other endpoints), and URLs. Some entries link to external sites. The slug 'cup' is the primary usable tournament slug for match/stats/standings endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rfs-ru-api-b230c53a/get_tournament_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_tournament_matches

Get all matches for a specific tournament by slug. Returns match IDs, team names, scores, and the tournament slug. Paginates as a single page returning all matches. Currently only the 'cup' slug (FONBET Russian Cup) is confirmed to return match data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | No | Tournament slug identifier. Currently 'cup' (FONBET Russian Cup) is the primary slug returning match data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rfs-ru-api-b230c53a/get_tournament_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_tournament_standings

Get tournament standings/group tables. Returns named tables with rows of cell values representing team standings including wins, draws, losses, goals, and points. First row typically contains column headers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | No | Tournament slug identifier. Currently 'cup' (FONBET Russian Cup) is confirmed to return standings. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rfs-ru-api-b230c53a/get_tournament_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_tournament_statistics

Get tournament player statistics such as top scorers. Returns categories (e.g. goals, assists) with rows containing player name, position, club, matches played, and scoring rate. Column headers are in Russian and vary by category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | No | Tournament slug identifier. Currently 'cup' (FONBET Russian Cup) is confirmed to return statistics. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rfs-ru-api-b230c53a/get_tournament_statistics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```