# Russian Football Union — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/russian-football-union/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/russian-football-union/get-match-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/russian-football-union/get-national-team-squad \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/russian-football-union/get-news-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/russian-football-union/get-tournament-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/russian-football-union/get-tournament-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/russian-football-union/get-tournament-standings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/russian-football-union/get-tournament-statistics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.