voleybol API Belgeleri

Basit REST API. API anahtarınızı sorgu parametresi olarak gönderin — başlık gerekmez.

Temel URL: https://live-volleyball-api.com/api/v1

Kimlik Doğrulama

Her istek URL'ine api_key ekleyin. Ücretsiz hesap oluşturarak anahtar alabilirsiniz.

https://live-volleyball-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-03

API anahtarınızı herkese açık istemci kodunda veya açık repolarda paylaşmayın.

Krediler

Her API çağrısı kredinizden düşer. Krediler hiç sona ermez. Yeni hesaplara 100 ücretsiz kredi verilir.

Endpoint	Maliyet
GET /matches	çağrı başına 1 kredi
GET /live_match_details	çağrı başına 1 kredi
GET /csb	Ücretsiz
GET /lineups	çağrı başına 1 kredi
GET /h2h	çağrı başına 1 kredi
GET /league	çağrı başına 1 kredi
GET /league_standings	çağrı başına 1 kredi
GET /league_fixtures	çağrı başına 1 kredi
GET /team_matches	çağrı başına 1 kredi
GET /team_squad	çağrı başına 1 kredi
GET /team_standings	çağrı başına 1 kredi
GET /player	çağrı başına 1 kredi
GET /team_search	çağrı başına 1 kredi
GET /player_search	çağrı başına 1 kredi
GET /league_search	çağrı başına 1 kredi

Hatalar

Tüm hatalar code ve message içeren JSON döner:

Kod	Anlam
400	Bad request — missing or invalid parameter
401	API key missing or invalid
403	Access denied — insufficient credits, daily limit exceeded, or inactive account
429	Insufficient credits
500	Database error
503	Upstream data source unavailable — retry after a few seconds

{
  "success": false,
  "message": "Access denied. Possible reasons: Invalid key, insufficient credits, daily limit exceeded, or inactive account.",
  "timestamp": "2026-07-03 14:22:01"
}

GET /matches

Belirtilen tarihteki voleybol maçlarını döner. Takım ve lig adlarını isteğe bağlı çevirebilirsiniz.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
date	string	Hayır	`YYYY-MM-DD` formatında maç tarihi
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-09-01&lang=en

Yanıt

{
  "success": true,
  "credits_remaining": 4999,
  "data": {
    "date": "2026-09-01",
    "language": "en",
    "timezone": "UTC+3",
    "matches": [
      {
        "id": "ae31818d-1eed-4f9f-abf7-84646dfe3aac",
        "league": {
          "id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
          "name": "European Championship Women Round of 16",
          "area": "World",
          "logo": "https://live-volleyball-api.com/leagues/b823d3cc-6286-1e9b-8ed5-e492f1761c40.png"
        },
        "date_time": "2026-09-01 16:20:00",
        "kickoff": "16:20",
        "status": {
          "status": "live",
          "display": "Live",
          "is_live": true
        },
        "home": {
          "id": "5740b6e3-8751-0dfd-1751-28c7cb764849",
          "name": "Turkey (W)",
          "logo": "https://live-volleyball-api.com/teams/5740b6e3-8751-0dfd-1751-28c7cb764849.png",
          "sets": 1
        },
        "away": {
          "id": "f206c54c-6d97-251a-cfdf-b74423417fa0",
          "name": "Azerbaijan (W)",
          "logo": "https://live-volleyball-api.com/teams/f206c54c-6d97-251a-cfdf-b74423417fa0.png",
          "sets": 0
        },
        "current_set_points": { "home": 11, "away": 10 },
        "tv_broadcast": true,
        "has_live_bet": true
      }
    ]
  },
  "timestamp": "2026-09-01 16:22:01"
}

status.status — scheduled, live, finished, cancelled, postponed değerlerinden biri. current_set_points — devam eden setin canlı sayı skoru; maç canlı değilse null. tv_broadcast / has_live_bet — kaynak veriden gelen boolean alanlar.

GET /live_match_details

Maç metadata'sını döner: turnuva/tur bilgisi, saha, yayın bilgisi, turnuva eşleşme ağacı (bracket) ve gömülebilir canlı yorum widget URL'si.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
match_id	string	Evet	`/matches` yanıtındaki maç kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/live_match_details?api_key=YOUR_KEY&match_id=ae31818d-1eed-4f9f-abf7-84646dfe3aac&lang=en

Yanıt

{
  "success": true,
  "credits_remaining": 4998,
  "data": {
    "match_id": "ae31818d-1eed-4f9f-abf7-84646dfe3aac",
    "title": "World - European Championship Women",
    "competition_name": "European Championship Women",
    "area_id": "b5f65d72-ec19-43d8-5ddb-a6ff45957d02",
    "league_id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
    "season_id": "1481a945-09d3-d8e9-d24d-caa45102514e",
    "date_time": "2026-09-01 16:20:00",
    "uncertain_time": false,
    "venue": "Sinan Erdem Sports Hall",
    "broadcasts": "TRT 1, tabii, TRT Spor Yıldız YouTube",
    "commentators": ["Cüneyt Kıran (TRT 1)"],
    "has_live_bet": true,
    "score": { "home": 3, "away": 0, "sets": [ { "home": 25, "away": 14 }, { "home": 25, "away": 16 }, { "home": 25, "away": 22 } ] },
    "statistics": {
      "columns": ["Pts", "Att", "Att%", "Blk", "Serve", "Serve%", "Ace", "Rec", "Rec%"],
      "home": [ { "player_id": "a4439911-fc85-c09a-2a43-fdceaadde144", "stats": { "Pts": "17", "Att": "13/30", "Att%": "%43", "Blk": "2", "Serve": "14/14", "Serve%": "%100", "Ace": "2", "Rec": "", "Rec%": "" } } ],
      "home_total": { "Pts": "58", "Att": "45/89", "Att%": "%51", "Blk": "7", "Serve": "67/73", "Serve%": "%92", "Ace": "6", "Rec": "44/47", "Rec%": "%94" },
      "away": [],
      "away_total": null
    },
    "home": {
      "id": "5740b6e3-8751-0dfd-1751-28c7cb764849",
      "name": "Turkey (W)",
      "logo": "https://live-volleyball-api.com/teams/5740b6e3-8751-0dfd-1751-28c7cb764849.png"
    },
    "away": {
      "id": "f206c54c-6d97-251a-cfdf-b74423417fa0",
      "name": "Azerbaijan (W)",
      "logo": "https://live-volleyball-api.com/teams/f206c54c-6d97-251a-cfdf-b74423417fa0.png"
    },
    "csb_url": "https://live-volleyball-api.com/csb?id=6743466&lang=en",
    "bracket": { "round_names": ["Round of 16", "Quarterfinal", "Semifinal", "Final"], "rounds": [ [] ] },
    "slug": "turkey-vs-azerbaijan"
  },
  "timestamp": "2026-09-01 16:22:01"
}

score — {home, away} biten set sayısı ve her setin sayısını içeren sets dizisi (maç canlıysa son eleman oynanmakta olan setin anlık sayısıdır). Hem lig hem eleme usulü maçlarda mevcuttur, maç henüz başlamadıysa null. bracket — turnuva eleme usulüyse tam eşleşme ağacını döner, lig usulü turnuvalarda null. statistics — her iki takım için oyuncu bazlı maç istatistikleri (sayı, hücum%, blok, servis%, ace, karşılama%) ve takım toplamları; sadece bazı liglerde/maçlarda mevcuttur, yoksa null.

csb_url — Canlı yorum widget'ı için kullanıma hazır, tamamen kendi domainimizden servis edilen iframe URL'si. Doğrudan yerleştirin: <iframe src="csb_url" width="636" height="400" frameborder="0"></iframe>
Maçın aktif widget beslemesi yoksa (örn. maç öncesi veya desteklenmeyen lig) null döner.

GET /csb

Canlı maç Centre Stage Board (CSB) görselleştirmesini HTML sayfa olarak döner — <iframe> içine yerleştirmek için tasarlanmıştır. /live_match_details yanıtındaki csb_url alanı zaten hazır token içeren URL'yi sağlar; çoğu durumda bu endpoint'i manuel çağırmanıza gerek yoktur.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
id	string	Evet	/live_match_details yanıtındaki `csb_url` sorgu dizesinden çıkarılan sayısal widget ID'si — bu URL'yi kendiniz oluşturmak yerine dönen `csb_url`'yi doğrudan iframe'e verin.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

<iframe
  src="https://live-volleyball-api.com/csb?id=6743466&lang=en"
  width="636"
  height="400"
  frameborder="0"
  allowtransparency="true"
></iframe>

id'yi sabit kodlamak yerine her zaman taze bir /live_match_details çağrısından alın — maç ertelenir veya tekrar oynanırsa widget ID'si değişebilir.

GET /lineups

Maç için bildirilen tam kadro listesini (forma numarası ve isim) döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
match_id	string	Evet	`/matches` yanıtındaki maç kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/lineups?api_key=YOUR_KEY&match_id=6f863cce-4607-46b5-bb14-1701d5247316&lang=en

Yanıt

{
  "success": true,
  "credits_remaining": 4997,
  "data": {
    "match_id": "6f863cce-4607-46b5-bb14-1701d5247316",
    "home": {
      "coach_name": "Daniele Capriotti",
      "players": [
        { "id": "010a289d-be42-f932-7f15-54d39782ebfb", "number": "7", "name": "A. Koulberg", "nationality_id": "a1f4a627-5510-54f7-0f17-98ee028b06bc", "image": "https://live-volleyball-api.com/people/010a289d-be42-f932-7f15-54d39782ebfb.png" },
        { "id": "0314d212-2fa0-d823-c3c2-f76bc54b5c43", "number": "10", "name": "P. Martin", "nationality_id": "a1f4a627-5510-54f7-0f17-98ee028b06bc", "image": "https://live-volleyball-api.com/people/0314d212-2fa0-d823-c3c2-f76bc54b5c43.png" }
      ]
    },
    "away": {
      "coach_name": "Konstantin Bitter",
      "players": [
        { "id": "example-away-player-id", "number": "5", "name": "K. Lohmann", "nationality_id": "example-nationality-id", "image": "https://live-volleyball-api.com/people/example-away-player-id.png" }
      ]
    }
  },
  "timestamp": "2026-09-01 14:22:01"
}

home ve away birer coach_name ve düz bir players kadro listesi içerir (ilk 11/yedek ayrımı yok) — voleybol verisinde diziliş değil, bildirilen kadro listesi raporlanır.

GET /h2h

İki takımın son 5 maçtaki formunu ve birbirlerine karşı geçmiş karşılaşma sonuçlarını döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
match_id	string	Evet	`/matches` yanıtındaki maç kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/h2h?api_key=YOUR_KEY&match_id=6f863cce-4607-46b5-bb14-1701d5247316&lang=en

Yanıt

{
  "success": true,
  "credits_remaining": 4996,
  "data": {
    "match_id": "6f863cce-4607-46b5-bb14-1701d5247316",
    "home_form": [
      { "id": "8f4a8162-9d46-8190-e45c-40e3fbfeba0d", "date": "2026-08-27", "home": "Netherlands (W)", "away": "Belgium (W)", "score": "2-3", "won": true }
    ],
    "away_form": [
      { "id": "9e2c1a77-1234-5678-9abc-def012345678", "date": "2026-08-28", "home": "Germany (W)", "away": "Poland (W)", "score": "1-3", "won": false }
    ],
    "h2h": [
      { "id": "example-h2h-match-id", "date": "2025-07-10", "home": "Belgium (W)", "away": "Germany (W)", "score": "3-1", "won": true }
    ],
    "home_series": [0, 1, 1, 1, 1],
    "away_series": [1, 0, 0, 1, 1],
    "win_code": "W",
    "lost_code": "L",
    "win_color": "#23CF4E",
    "lost_color": "#D1494E"
  },
  "timestamp": "2026-09-01 14:22:01"
}

home_series / away_series — home_form / away_form ile aynı sırada, son 5 maçın 0/1 galibiyet-mağlubiyet dizisi. win_code / lost_code / win_color / lost_color — bu dizideki 1 veya 0'ı yorumlamak için kaynağın kendi etiket/renk açıklaması.

GET /league

Bir ligin sezon, takımlar ve logo dahil detaylı bilgisini döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
league_id	string	Evet	`/leagues` yanıtındaki lig kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/league?api_key=YOUR_KEY&league_id=b823d3cc-6286-1e9b-8ed5-e492f1761c40&lang=en

Yanıt

{
  "success": true,
  "credits_remaining": 4993,
  "data": {
    "id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
    "name": "European Championship Women",
    "slug": "trendyol-european-championship-women",
    "logo": "https://live-volleyball-api.com/leagues/b823d3cc-6286-1e9b-8ed5-e492f1761c40.png",
    "area": { "id": "b5f65d72-ec19-43d8-5ddb-a6ff45957d02", "name": "World" },
    "seasons": [
      { "id": "1481a945-09d3-d8e9-d24d-caa45102514e", "name": "2026", "selected": true },
      { "id": "bedd9910-09f0-8286-cc5f-90baf99d6006", "name": "2023", "selected": false }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

seasons dizisindeki her kayıt seçilebilir bir sezondur — mevcut sezon yerine geçmiş bir sezonu görüntülemek için id değerini /league_standings veya /league_fixtures'e season_id olarak geçirin.

GET /league_standings

Bir ligin güncel puan tablosunu döner. Çok gruplu müsabakaları destekler.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
league_id	string	Evet	`/leagues` yanıtındaki lig kimliği
season_id	string	Hayır	/league yanıtındaki `seasons` dizisinden gelen sezon UUID'si. Mevcut sezon için boş bırakın.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/league_standings?api_key=YOUR_KEY&league_id=b823d3cc-6286-1e9b-8ed5-e492f1761c40&lang=en

Yanıt

{
  "success": true,
  "credits_remaining": 4992,
  "data": {
    "league_id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
    "columns": ["Rank", "Team", "P", "W", "L", "S", "Pts"],
    "tabs": ["Overall", "Home", "Away"],
    "zones": [ { "id": "836572bd-a2fe-1404-1743-964ec9c7baca", "name": "Qualified", "color": "#02206B" } ],
    "standings": [
      {
        "title": "Group A",
        "round_id": "99d8f31f-42b5-dd52-62e5-d7e4a7ee8fdb",
        "group_id": "99d8f31f-42b5-dd52-62e5-d7e4a7ee8fdb",
        "week": 5,
        "max_week": 5,
        "total": [
          {
            "team_id": "83f6313f-0cb3-ca49-c3c9-d8daaf1ce99d",
            "team_name": "Poland (W)",
            "logo": "https://live-volleyball-api.com/teams/83f6313f-0cb3-ca49-c3c9-d8daaf1ce99d.png",
            "columns": ["1", "Poland (W)", "5", "5", "0", "15-3", "14"],
            "zone_id": "836572bd-a2fe-1404-1743-964ec9c7baca"
          }
        ],
        "home": [ ],
        "away": [ ]
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

columns, her satırın columns dizisindeki değerlerin (aynı sırada) yerelleştirilmiş sütun başlıklarını verir. tabs mevcut tablo görünümlerini listeler (genel/iç saha/deplasman) — her puan durumu grubunda buna karşılık gelen total / home / away dizileri bulunur. zones, her satırın zone_id'sinin işaret ettiği Avrupa kupası/küme düşme bölgesi renklerini açıklar.

GET /league_fixtures

Bir ligin tüm fikstürünü hafta hafta döner; oynanan maçlar için skor, gelecek maçlar için başlama saati içerir.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
league_id	string	Evet	`/leagues` yanıtındaki lig kimliği
season_id	string	Hayır	/league yanıtındaki `seasons` dizisinden gelen sezon UUID'si. Mevcut sezon için boş bırakın.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/league_fixtures?api_key=YOUR_KEY&league_id=b823d3cc-6286-1e9b-8ed5-e492f1761c40&lang=tr

Yanıt

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "league_id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
    "weeks": [
      {
        "title": "1. Week",
        "matches": [
          {
            "id": "9a674f49-43f5-2447-56f1-71681ac5801e",
            "date_time": "2026-08-21 11:00:00",
            "status": "finished",
            "home": {
              "id": "d682a14f-59a3-a7fe-c7ab-0c3efe87fe24",
              "name": "France (W)",
              "logo": "https://live-volleyball-api.com/teams/d682a14f-59a3-a7fe-c7ab-0c3efe87fe24.png",
              "sets": 3
            },
            "away": {
              "id": "747b36c4-61e7-e3ab-6ab0-a8dedfa5d852",
              "name": "Slovakia (W)",
              "logo": "https://live-volleyball-api.com/teams/747b36c4-61e7-e3ab-6ab0-a8dedfa5d852.png",
              "sets": 0
            }
          }
        ]
      }
    ],
    "bracket": null
  },
  "timestamp": "2026-08-31 12:00:00"
}

bracket — eleme usulü turnuvanın tam eşleşme ağacı (tur adları ve her eşleşmenin takımları/skoru), lig usulü turnuvalarda null.

GET /team_matches

Bir takımın sezon fikstürünü ve sonuçlarını döner — geçmiş ve yaklaşan maçlar.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
team_id	string	Evet	Maç verisindeki takım kimliği
season	string	Hayır	Sezon yılı, örn. `2026`. Mevcut sezon için boş bırakın.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/team_matches?api_key=YOUR_KEY&team_id=547c6214-9072-0db0-cf71-35eacb40f104&season=2026&lang=en

Yanıt

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
    "season": "2026",
    "competitions": [
      {
        "id": "d1e7325d-5b84-4735-bf93-8d08da440deb",
        "title": "World - International Friendly Women",
        "area_id": "b5f65d72-ec19-43d8-5ddb-a6ff45957d02",
        "rounds": [
          {
            "id": "59c4337f-9b1c-4bab-b7dd-a300d32d9965",
            "name": "Regular Season",
            "matches": [
              {
                "id": "9d3939df-0c5b-4ea6-ac29-75c8a1717cba",
                "date_time": "2026-05-14 19:00:00",
                "status": "finished",
                "home": { "id": "547c6214-9072-0db0-cf71-35eacb40f104", "name": "Italy (W)", "logo": "https://live-volleyball-api.com/teams/547c6214-9072-0db0-cf71-35eacb40f104.png", "sets": 3 },
                "away": { "id": "d682a14f-59a3-a7fe-c7ab-0c3efe87fe24", "name": "France (W)", "logo": "https://live-volleyball-api.com/teams/d682a14f-59a3-a7fe-c7ab-0c3efe87fe24.png", "sets": 0 },
                "won": true
              }
            ]
          }
        ]
      }
    ],
    "win_code": "W",
    "lost_code": "L",
    "win_color": "#23CF4E",
    "lost_color": "#D1494E"
  },
  "timestamp": "2026-09-01 14:22:01"
}

GET /team_squad

Bir takımın oyuncu pozisyonları ve sırt numaraları ile tam kadrosunu döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
team_id	string	Evet	Maç verisindeki takım kimliği
season	string	Hayır	Sezon yılı, örn. `2026`. Mevcut sezon için boş bırakın.
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/team_squad?api_key=YOUR_KEY&team_id=547c6214-9072-0db0-cf71-35eacb40f104

Yanıt

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
    "name": "Italy (W)",
    "slug": "italy-women",
    "type": 22,
    "logo": "https://live-volleyball-api.com/teams/547c6214-9072-0db0-cf71-35eacb40f104.png",
    "season": "2026",
    "available_seasons": ["2026", "2026 Italy", "2025", "2024 Paris", "2024", "2023", "2022"],
    "column_names": ["No", "Player", "P", "Age", "M", "Points", "Blk"],
    "coach": {
      "id": "c3d1b6c7-9278-4a14-8fc4-09b3a5a34161",
      "name": "Julio Velasco",
      "nationality_id": "501dc4bd-8129-8c1b-9873-704cb5165dee",
      "image": "https://live-volleyball-api.com/people/c3d1b6c7-9278-4a14-8fc4-09b3a5a34161.png"
    },
    "players": [
      {
        "id": "168ec450-c327-a648-8325-f2f3b4088d18",
        "name": "M. Sylla",
        "number": "17",
        "nationality_id": "8e69dfd6-38ee-7738-3d1c-2028011930f8",
        "nationality": "Italy",
        "active_team_id": "f75aa922-8e34-70e7-2c75-9635c1ce3a87",
        "active_team_name": "Galatasaray Daikin (W)",
        "image": "https://live-volleyball-api.com/people/168ec450-c327-a648-8325-f2f3b4088d18.png",
        "columns": ["17", "M. Sylla", "S", "32", "12", "8.7", "0.8"]
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

column_names, her oyuncunun columns dizisindeki değerlerin (aynı sırada) yerelleştirilmiş sütun başlıklarını verir — tam istatistik sütunları turnuvaya göre değişir. type, kaynağın kendi sayısal takım kategorisi kodudur, anlamı belgelenmemiştir — olduğu gibi kullanın.

GET /team_standings

Bir takımın mevcut sezondaki lig(ler)deki pozisyonunu döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
team_id	string	Evet	Maç verisindeki takım kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/team_standings?api_key=YOUR_KEY&team_id=547c6214-9072-0db0-cf71-35eacb40f104&season=2026&lang=en

Yanıt

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
    "season": "2026",
    "columns": ["Rank", "Team", "P", "W", "L", "S", "Pts"],
    "tabs": ["Overall", "Home", "Away"],
    "zones": [
      { "id": "6a4acb0f-3450-cec7-199a-d2a0e34c96ea", "name": "Final Round", "color": "#0046C5", "darkModeColor": "#0046C5" }
    ],
    "standings": [
      {
        "title": "Nations League Women",
        "round_id": "bcb2531a-c8d3-402e-a8e1-a3647b8a4f6c",
        "group_id": "6a4acb0f-3450-cec7-199a-d2a0e34c96ea",
        "week": 12,
        "max_week": 12,
        "total": [
          {
            "team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
            "team_name": "Italy (W)",
            "logo": "https://live-volleyball-api.com/teams/547c6214-9072-0db0-cf71-35eacb40f104.png",
            "columns": ["2", "Italy (W)", "12", "10", "2", "32-14", "28"],
            "zone_id": "6a4acb0f-3450-cec7-199a-d2a0e34c96ea"
          }
        ],
        "home": [ ],
        "away": [ ]
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

GET /team_search

İsme göre takım arar. Eşleşen takımları ID ve logolarıyla birlikte döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
q	string	Evet	Arama kelimesi (takım veya oyuncu adı)
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/team_search?api_key=YOUR_KEY&q=eczacibasi

Yanıt

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "keywords": "eczacibasi",
    "total": 3,
    "teams": [
      {
        "id": "f244f38b-d084-9902-b52e-e068873c4a46",
        "name": "Eczacıbaşı Peron İstanbul (W)",
        "logo": "https://live-volleyball-api.com/teams/f244f38b-d084-9902-b52e-e068873c4a46.png",
        "country": "Turkey"
      },
      {
        "id": "a00b9015-94e6-c24f-9c9a-3e4ecdfffdcf",
        "name": "Eczacıbaşı II (W)",
        "logo": "https://live-volleyball-api.com/teams/a00b9015-94e6-c24f-9c9a-3e4ecdfffdcf.png",
        "country": "Turkey"
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

GET /player

Bir oyuncunun profilini (biyografi, mevki, boy/kilo, mevcut kulübü) ve sezon sezon ile kulüp/milli takım bazlı kariyer istatistiklerini döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
player_id	string	Evet	`/player_search` yanıtındaki oyuncu kimliği
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/player?api_key=YOUR_KEY&player_id=0d66ae65-5596-8a3f-9165-a1d3d5e47d14&lang=en

Yanıt

{
  "success": true,
  "credits_remaining": 4988,
  "data": {
    "player_id": "0d66ae65-5596-8a3f-9165-a1d3d5e47d14",
    "name": "Sinead Jack-Kısal",
    "shirt_number": "88",
    "photo": "https://live-volleyball-api.com/people/0d66ae65-5596-8a3f-9165-a1d3d5e47d14.png",
    "team_id": "c86225f5-6f73-0097-474f-45c9a2357948",
    "team_logo": "https://live-volleyball-api.com/teams/c86225f5-6f73-0097-474f-45c9a2357948.png",
    "profile": [
      { "label": "First Name", "value": "Sinead" },
      { "label": "Last Name", "value": "Jack-Kısal" },
      { "label": "Date of Birth", "value": "08 Nov 1993 (Age: 33)" },
      { "label": "Nationality", "value": "Turkey" },
      { "label": "Height", "value": "196 cm" },
      { "label": "Weight", "value": "83 kg" },
      { "label": "Position", "value": "Middle Blocker" },
      { "label": "Hand", "value": "Right" },
      { "label": "Club", "value": "Fenerbahçe (W)" }
    ],
    "career": {
      "column_names": ["Season", "Team", "Matches", "Points", "Blk"],
      "seasons": [
        { "team_id": "f244f38b-d084-9902-b52e-e068873c4a46", "team_logo": "https://live-volleyball-api.com/teams/f244f38b-d084-9902-b52e-e068873c4a46.png", "columns": ["2025/2026", "Eczacıbaşı Peron İstanbul (W)", "43", "9.5", "2.7"] }
      ]
    },
    "clubs": {
      "column_names": ["Years", "Team", "Matches", "Points", "Blk"],
      "rows": [
        { "team_id": "f244f38b-d084-9902-b52e-e068873c4a46", "team_logo": "https://live-volleyball-api.com/teams/f244f38b-d084-9902-b52e-e068873c4a46.png", "columns": ["2022 - Present", "Eczacıbaşı Dynavit (W)", "153", "6.2", "1.6"] }
      ]
    },
    "national_teams": {
      "column_names": ["Years", "Team", "Matches", "Points", "Blk"],
      "rows": [
        { "team_id": "5740b6e3-8751-0dfd-1751-28c7cb764849", "team_logo": "https://live-volleyball-api.com/teams/5740b6e3-8751-0dfd-1751-28c7cb764849.png", "columns": ["2025 - Present", "Turkey (W)", "22", "7.4", "1.5"] }
      ]
    },
    "slug": "sinead-jack-kisal"
  },
  "timestamp": "2026-09-01 14:22:01"
}

profile, kaynaktan geldiği gibi yerelleştirilmiş etiket/değer çiftlerinden oluşan bir listedir — alan sırası ve etiketler oyuncuya göre değişebilir. career sezon sezon, clubs / national_teams ise her kulüp veya milli takım dönemini tek satırda özetler.

GET /player_search

İsme göre oyuncu arar. Eşleşen oyuncuları ID ve fotoğraflarıyla birlikte döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
q	string	Evet	Arama kelimesi (takım veya oyuncu adı)
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/player_search?api_key=YOUR_KEY&q=antropova

Yanıt

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "keywords": "antropova",
    "total": 1,
    "players": [
      {
        "id": "23bf9fb8-bcc8-5ee0-14c4-f227d4081895",
        "name": "E. Antropova",
        "photo": "https://live-volleyball-api.com/people/23bf9fb8-bcc8-5ee0-14c4-f227d4081895.png",
        "country": "Italy"
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

GET /league_search

İsme göre lig/turnuva arar. Eşleşen turnuvaları ID ve logolarıyla birlikte döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
api_key	string	Evet	API anahtarınız
q	string	Evet	Arama kelimesi (takım veya oyuncu adı)
lang	string	Hayır	Yanıt dili: `en` `tr` `de` `ru`

Örnek istek

GET https://live-volleyball-api.com/api/v1/league_search?api_key=YOUR_KEY&q=nations league

Yanıt

{
  "success": true,
  "credits_remaining": 4988,
  "data": {
    "keywords": "nations league",
    "total": 2,
    "leagues": [
      {
        "id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
        "name": "European Championship Women",
        "logo": "https://live-volleyball-api.com/leagues/b823d3cc-6286-1e9b-8ed5-e492f1761c40.png",
        "area": "World"
      }
    ]
  },
  "timestamp": "2026-09-02 14:22:01"
}