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

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",
    "has_live_bet": true,
    "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"
}

bracket — turnuva eleme usulüyse tam eşleşme ağacını döner, lig usulü turnuvalarda null. Bu endpoint canlı olay zaman çizelgesi veya maç içi istatistik içermez — canlı set skoru için /matches kullanın.

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": [
      { "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": [
      { "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 düz bir kadro listesidir (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]
  },
  "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.

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",
    "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
            }
          }
        ]
      }
    ]
  },
  "timestamp": "2026-08-31 12:00:00"
}

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
              }
            ]
          }
        ]
      }
    ]
  },
  "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)",
    "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.

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"],
    "standings": [
      {
        "title": "Nations League Women",
        "round_id": "bcb2531a-c8d3-402e-a8e1-a3647b8a4f6c",
        "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"
          }
        ]
      }
    ]
  },
  "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"
}

Bu arama motoru mackolikfeeds'in sunduğu tüm sporları (futbol, basketbol, voleybol vb.) tek bir dizinde tutuyor ve açık bir spor alanı yok — sunucu tarafında sadece voleybol sonuçlarını filtreleyip döndürüyoruz, yanıtta başka spor takım/oyuncuları hiç görünmez.

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"
}