Discover/Volley API
live

Volley APIvolley.ru

Access real-time Russian volleyball match schedules, results, and team lineups from the official VFV federation database. Plan your viewing, track team performance, and stay updated on roster compositions for matches across all major Russian volleyball competitions.

This API takes change requests — .
Endpoint health
monitored
get_match_lineup
get_matches
Checks pendingself-healing
Endpoints
2
Updated
4h ago
Try it
Filter matches to a specific date in ISO format YYYY-MM-DD (e.g. 2026-05-17). When omitted, all matches in the competition are returned.
Competition identifier from volley.ru (e.g. from a calendar page URL). When omitted, defaults to Кубок России 2026 Мужчины.
api.parse.bot/scraper/cfd8cbaa-62a4-4efe-b2cb-62242b3cffa4/<endpoint>
Ready to send
Fill in the parameters and hit sign in to send to see live response data here.
Call it over HTTPgrab a free API key at signup
curl -X GET 'https://api.parse.bot/scraper/cfd8cbaa-62a4-4efe-b2cb-62242b3cffa4/get_matches?date=2026-05-17&competition_id=01K073HE7F023416SWXBSY1RJT' \
  -H 'X-API-Key: $PARSE_API_KEY'
Python SDK · recommended

Typed, relational, agent-ready

A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.

  • Fully typed · autocompletes
  • Objects link to objects
  • Typed errors & pagination

Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:

uv add parse-sdk
uv run parse init
uv run parse add --marketplace volley-ru-api

uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.

"""Walkthrough: volley_ru_api SDK — bounded, re-runnable; every call capped."""
from parse_apis.volley_ru_api import Volley, MatchNotFound

client = Volley()

# List matches from a competition, filtered by date.
# competition_id comes from volley.ru calendar URLs (public site identifiers).
comp = client.competition(competition_id="cup-russia-2026-men")
for match in comp.matches(date="2026-05-17", limit=3):
    print(match.team_a, match.score_a, ":", match.score_b, match.team_b, match.stage)

# Take one match and fetch its full lineup
first_match = comp.matches(limit=1).first()
if first_match:
    try:
        lineup = first_match.lineup()
        print(lineup.team_a.name, "vs", lineup.team_b.name)
        for player in lineup.team_a.players[:3]:
            print(player.name, player.number, player.position)
    except MatchNotFound as e:
        print("match gone:", e.match_id)

print("exercised: competition.matches / match.lineup")
All endpoints · 2 totalmissing one? ·

Retrieve volleyball matches from a competition. Returns match list with IDs, teams, dates, scores, set results, stage, and venue. Results are auto-iterated from a single competition page. When a date filter is applied, only matches on that specific date are returned.

Input
ParamTypeDescription
datestringFilter matches to a specific date in ISO format YYYY-MM-DD (e.g. 2026-05-17). When omitted, all matches in the competition are returned.
competition_idstringCompetition identifier from volley.ru (e.g. from a calendar page URL). When omitted, defaults to Кубок России 2026 Мужчины.
Response
{
  "type": "object",
  "fields": {
    "matches": "array of match objects with match_id, date, time, teams, scores, set_scores, stage, venue, status",
    "competition": "competition name string",
    "total_matches": "number of matches returned",
    "competition_id": "competition identifier"
  },
  "sample": {
    "data": {
      "matches": [
        {
          "date": "17.05.2026",
          "time": "19:00",
          "stage": "ФИНАЛ ШЕСТИ. ФИНАЛ МУЖЧИНЫ",
          "venue": "Москва",
          "status": "completed",
          "team_a": "Зенит",
          "team_b": "Динамо",
          "score_a": 2,
          "score_b": 3,
          "match_id": "01KRNCBVDVC2AD0D4YHSQR1G9W",
          "set_scores": [
            "25 : 21",
            "25 : 19",
            "24 : 26",
            "13 : 25",
            "10 : 15"
          ],
          "competition": "Кубок России 2026.Мужчины"
        }
      ],
      "competition": "Кубок России 2026.Мужчины",
      "total_matches": 2,
      "competition_id": "01K073HE7F023416SWXBSY1RJT"
    },
    "status": "success"
  }
}

About the Volley API

The Volley API on Parse exposes 2 endpoints for the publicly available data on volley.ru. Calls return JSON over HTTPS and are billed per successful response.

Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.