tenis API Belgeleri

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

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

Kimlik Doğrulama

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

https://live-tennis-api.com/api/v1/matches?api_key=YOUR_KEY

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 /match/scores	çağrı başına 1 kredi
GET /match/statistics	çağrı başına 1 kredi
GET /match/h2h	çağrı başına 1 kredi
GET /match/tracker	Ücretsiz — API key gerekmez
GET /rankings	çağrı başına 1 kredi
GET /tournament/details	çağrı başına 1 kredi
GET /tournament/bracket	çağrı başına 1 kredi
GET /tournament/results	çağrı başına 1 kredi
GET /player/profile	çağrı başına 1 kredi
GET /player/matches	çağrı başına 1 kredi
GET /player/statistics	çağrı başına 1 kredi
GET /webhook/register	Ücretsiz — API key gerekmez
GET /webhook/list	Ücretsiz — API key gerekmez
GET /webhook/delete	Ücretsiz — API key gerekmez

Kalan bakiye her yanıtta credits_remaining alanında ve X-Credits-Remaining başlığında döner.

Hatalar

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

{ "error": "Invalid API key.", "code": 401 }

Kod	Anlam
401	Eksik veya geçersiz `api_key`
402	Yetersiz kredi
400	Geçersiz parametre (örn. hatalı tarih formatı)
503	Kaynak veri servisi erişilemez

GET /matches

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

GET /api/v1/matches 1 credit

Parametreler

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

Örnek istekler

# Today's matches (English)
https://live-tennis-api.com/api/v1/matches?api_key=YOUR_KEY

# Specific date
https://live-tennis-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-13

# Turkish translation
https://live-tennis-api.com/api/v1/matches?api_key=YOUR_KEY&lang=tr

# Russian + specific date
https://live-tennis-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-13&lang=ru
                

curl "https://live-tennis-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-06-29&lang=en"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/matches'
  + '?api_key=YOUR_KEY&date=2026-06-29&lang=en'
);
const data = await res.json();
console.log(data.matches);
                

<?php
$url = 'https://live-tennis-api.com/api/v1/matches'
      . '?api_key=YOUR_KEY&date=2026-06-29&lang=en';

$data = json_decode(file_get_contents($url), true);
var_dump($data['matches']);
                

import requests

data = requests.get(
    'https://live-tennis-api.com/api/v1/matches',
    params={
        'api_key': 'YOUR_KEY',
        'date': '2026-06-29',
        'lang': 'en',
    }
).json()
print(data['matches'])
                

Yanıt

{
  "status": "ok",
  "date":   "2026-07-13",
  "count":  87,
  "matches": [
    {
      "id":              16495405,
      "start_timestamp": 1783950600,
      "status":          "finished",
      "player1": {
        "id":      244420,
        "name":    "Jesper De Jong",
        "country": "NL",
        "ranking": 73
      },
      "player2": {
        "id":      322022,
        "name":    "Vilius Gaubas",
        "country": "LT",
        "ranking": 128
      },
      "tournament": {
        "id":      2413,
        "name":    "Bastad",
        "tour":    "ATP",
        "surface": "Red clay"
      },
      "round":  "Round of 32",
      "score": {
        "sets_won": [2, 0],
        "s1":       [7, 6],
        "s1_tb":    [7, 1],
        "s2":       [7, 5]
      },
      "winner": "player1"
    }
  ],
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
id	integer	Match ID
start_timestamp	integer	Scheduled start time as a Unix timestamp (UTC)
status	string	Raw match status — `notstarted`, `inprogress`, `finished`, `postponed`, `cancelled`, `walkover`, `retired`
player1 / player2	object	Player `id`, `name`, `country` (ISO-2), `ranking` (integer\|null), `photo` (proxied image URL)
tournament.id	integer\|null	Tournament ID
tournament.name	string\|null	Tournament name
tournament.tour	string\|null	Tour name — ATP, WTA, ITF, etc.
tournament.surface	string\|null	Court surface — e.g. `Red clay`, `Grass`, `Hard`
round	string\|null	Round label — e.g. `Final`, `Semifinal`, `Round of 32`
score.sets_won	array	[player1_sets, player2_sets]
score.s1–s5	array	[player1_games, player2_games] per set; only present if the set was played
score.s1_tb–s5_tb	array	[player1_points, player2_points] tiebreak score; only present if a tiebreak was played in that set
winner	string\|null	`"player1"`, `"player2"`, or `null` if the match is not finished
credits_remaining	integer\|string	Credits left after this call. `"unlimited"` for subscription users

GET /match/scores

Belirli bir maç için anlık skor, set dökümü ve canlı oyun skorunu döner. Canlı maçlarda önbellek 30 saniyedir.

GET /api/v1/match/scores 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
match_id	Evet	—	Match ID from `GET /matches` (`id` field)
lang	Hayır	`en`	Yanıt dili: `en` `tr` `de` `ru`

Örnek istekler

https://live-tennis-api.com/api/v1/match/scores?api_key=YOUR_KEY&match_id=16498578
                

curl "https://live-tennis-api.com/api/v1/match/scores?api_key=YOUR_KEY&match_id=16498578"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/match/scores'
  + '?api_key=YOUR_KEY&match_id=16498578'
);
const data = await res.json();
console.log(data.score);
                

<?php
$url = 'https://live-tennis-api.com/api/v1/match/scores'
      . '?api_key=YOUR_KEY&match_id=16498578';

$data = json_decode(file_get_contents($url), true);
var_dump($data['score']);
                

import requests

data = requests.get(
    'https://live-tennis-api.com/api/v1/match/scores',
    params={'api_key': 'YOUR_KEY', 'match_id': 16498578}
).json()
print(data['score'])
                

Yanıt

{
  "status":      "ok",
  "match_id":    16498578,
  "tracker_url": "https://live-tennis-api.com/api/v1/match/tracker?match_id=16498578&lang=en",
  "match": {
    "status":          "inprogress",
    "status_detail":   "3rd set",
    "start_timestamp": 1783967700,
    "player1": { "id": 217464, "name": "Rio Noguchi",    "country": "JP", "ranking": 222, "photo": "https://live-tennis-api.com/image/players/217464.png" },
    "player2": { "id": 202181, "name": "Charles Broom", "country": "GB", "ranking": 283, "photo": "https://live-tennis-api.com/image/players/202181.png" },
    "tournament": { "id": 23140, "name": "ATP Challenger Lincoln", "tour": "Challenger", "surface": "Hardcourt outdoor" },
    "round": "Round of 32"
  },
  "score": {
    "sets_won":    [1, 1],
    "s1":          [6, 2],
    "s2":          [4, 6],
    "s3":          [6, 5],
    "current_game": { "player1": "A", "player2": "40" },
    "serving":     "player1"
  },
  "winner":            null,
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
match_id	integer	The requested match ID
tracker_url	string	Ready-to-embed URL for `GET /match/tracker` — no API key required, safe to use as iframe `src`
match.status	string	`notstarted`, `inprogress`, `finished`, `postponed`, `cancelled`
match.status_detail	string\|null	Human-readable detail — e.g. `"3rd set"`, `"Ended"`
match.start_timestamp	integer	Match start as a Unix timestamp (UTC)
match.player1 / player2	object	`id`, `name`, `country` (ISO-2), `ranking` (integer\|null), `photo` (proxied image URL)
match.tournament	object	`id`, `name`, `tour`, `surface`
match.round	string\|null	Round label — e.g. `"Final"`, `"Round of 32"`
score.sets_won	array	[player1_sets, player2_sets]
score.s1–s5	array	[player1_games, player2_games] per set; only present if the set was played
score.s1_tb–s5_tb	array	Tiebreak score for that set; only present if a tiebreak was played
score.current_game	object\|—	Live game score `{player1, player2}` — values: `"0"` `"15"` `"30"` `"40"` `"A"`. Only present when `status` is `inprogress`
score.serving	string\|—	`"player1"` or `"player2"` — who is currently serving. Only present when `status` is `inprogress`
winner	string\|null	`"player1"`, `"player2"`, or `null`
credits_remaining	integer\|string	Credits left after this call. `"unlimited"` for subscription users

GET /match/statistics

Maç istatistiklerini dönem bazında (TÜM + her set) döner. Her iki oyuncu için servis, ritern, puan, oyun ve diğer istatistikleri içerir.

GET /api/v1/match/statistics 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
match_id	Evet	—	Match ID from `GET /matches`
lang	Hayır	`en`	Yanıt dili: `en` `tr` `de` `ru`

Örnek istekler

https://live-tennis-api.com/api/v1/match/statistics?api_key=YOUR_KEY&match_id=16498578
                

curl "https://live-tennis-api.com/api/v1/match/statistics?api_key=YOUR_KEY&match_id=16498578"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/match/statistics'
  + '?api_key=YOUR_KEY&match_id=16498578'
);
const data = await res.json();
console.log(data.statistics);
                

<?php
$url = 'https://live-tennis-api.com/api/v1/match/statistics'
      . '?api_key=YOUR_KEY&match_id=16498578';

$data = json_decode(file_get_contents($url), true);
var_dump($data['statistics']);
                

import requests

data = requests.get(
    'https://live-tennis-api.com/api/v1/match/statistics',
    params={'api_key': 'YOUR_KEY', 'match_id': 16498578}
).json()
print(data['statistics'])
                

Yanıt

{
  "status":   "ok",
  "match_id": 16498578,
  "statistics": [
    {
      "period": "ALL",
      "groups": [
        {
          "name": "Service",
          "stats": [
            { "key": "aces",                "label": "Aces",               "player1": "0",              "player2": "2",              "player1_value": 0,   "player2_value": 2   },
            { "key": "double_faults",       "label": "Double faults",      "player1": "5",              "player2": "4",              "player1_value": 5,   "player2_value": 4   },
            { "key": "first_serve_accuracy", "label": "First serve",        "player1": "66/105 (63%)", "player2": "47/86 (55%)", "player1_value": 66,  "player2_value": 47  },
            { "key": "break_points_saved",   "label": "Break points saved", "player1": "3/7 (42%)",    "player2": "3/9 (33%)",    "player1_value": 3,   "player2_value": 3   }
          ]
        },
        {
          "name": "Points",
          "stats": [
            { "key": "points_total",           "label": "Total",                   "player1": "103", "player2": "87", "player1_value": 103, "player2_value": 87 },
            { "key": "service_points_scored",  "label": "Service points won",  "player1": "63",  "player2": "46", "player1_value": 63,  "player2_value": 46 },
            { "key": "receiver_points_scored", "label": "Receiver points won", "player1": "40",  "player2": "42", "player1_value": 40,  "player2_value": 42 }
          ]
        }
      ]
    },
    { "period": "1ST", "groups": [ /* same structure */ ] },
    { "period": "2ND", "groups": [ /* same structure */ ] },
    { "period": "3RD", "groups": [ /* same structure */ ] }
  ],
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
statistics	array	One entry per period — `ALL` (full match) + one per set played (`1ST`, `2ND`, `3RD`…)
period	string	`"ALL"`, `"1ST"`, `"2ND"`, `"3RD"`, `"4TH"`, `"5TH"`
groups[].name	string	Stat group — `Service`, `Points`, `Games`, `Return`, `Miscellaneous`
stats[].key	string	Snake_case stat key — e.g. `aces`, `first_serve_accuracy`, `break_points_saved`
stats[].label	string	Human-readable stat name in English
stats[].player1 / player2	string	Display value — plain number or fraction with % (e.g. `"66/105 (63%)"`)
stats[].player1_value / player2_value	integer	Raw numeric value (numerator for fraction stats)
credits_remaining	integer\|string	Credits left after this call. `"unlimited"` for subscription users

GET /match/h2h

İki oyuncu arasındaki karşılaşma özetini, tüm tarihsel maçları ve her oyuncunun son 5 maçını (son form) döner.

GET /api/v1/match/h2h 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
match_id	Evet	—	Match ID from `GET /matches`
lang	Hayır	`en`	Yanıt dili: `en` `tr` `de` `ru`

Örnek istekler

https://live-tennis-api.com/api/v1/match/h2h?api_key=YOUR_KEY&match_id=16498578
                

curl "https://live-tennis-api.com/api/v1/match/h2h?api_key=YOUR_KEY&match_id=16498578"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/match/h2h'
  + '?api_key=YOUR_KEY&match_id=16498578'
);
const data = await res.json();
console.log(data.meetings, data.recent_form);
                

<?php
$url = 'https://live-tennis-api.com/api/v1/match/h2h'
      . '?api_key=YOUR_KEY&match_id=16498578';

$data = json_decode(file_get_contents($url), true);
var_dump($data['summary']);
                

import requests

data = requests.get(
    'https://live-tennis-api.com/api/v1/match/h2h',
    params={'api_key': 'YOUR_KEY', 'match_id': 16498578}
).json()
print(data['meetings'])
                

Yanıt

{
  "status":   "ok",
  "match_id": 16498578,
  "player1": { "id": 217464, "name": "Rio Noguchi",    "country": "JP", "ranking": 222, "photo": "https://live-tennis-api.com/image/players/217464.png" },
  "player2": { "id": 202181, "name": "Charles Broom", "country": "GB", "ranking": 283, "photo": "https://live-tennis-api.com/image/players/202181.png" },
  "summary": {
    "player1_wins": 1,
    "player2_wins": 0,
    "total":        1
  },
  "meetings": [
    {
      "id":              16498578,
      "start_timestamp": 1783967700,
      "status":          "finished",
      "player1": { "id": 217464, "name": "Rio Noguchi",    "country": "JP", "ranking": 222, "photo": "..." },
      "player2": { "id": 202181, "name": "Charles Broom", "country": "GB", "ranking": 283, "photo": "..." },
      "tournament": { "id": 23140, "name": "ATP Challenger Lincoln", "tour": "Challenger", "surface": "Hardcourt outdoor" },
      "round": "Round of 32",
      "score": { "sets_won": [2, 1], "s1": [6, 2], "s2": [4, 6], "s3": [7, 5] },
      "winner": "player1",
      "result": "win"
    }
  ],
  "recent_form": {
    "player1": [ /* last 5 matches for Rio Noguchi, same match object structure */ ],
    "player2": [ /* last 5 matches for Charles Broom, same match object structure */ ]
  },
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
player1 / player2	object	Players of the requested match — `id`, `name`, `country`, `ranking`, `photo`
summary.player1_wins	integer	Head-to-head wins for player1 in all-time meetings
summary.player2_wins	integer	Head-to-head wins for player2 in all-time meetings
summary.total	integer	Total number of H2H meetings ever played
meetings[]	array	Historical meetings between the two players, most recent first
meetings[].winner	string\|null	`"player1"` or `"player2"` — refers to the home/away of that specific match
meetings[].result	string\|null	`"win"` or `"loss"` — from player1's perspective (the home team of the current requested match)
recent_form.player1[]	array	Last 5 matches for player1, excluding the current match. Same object structure as `meetings[]`
recent_form.player2[]	array	Last 5 matches for player2, excluding the current match
score.sets_won	array	[player1_sets, player2_sets]
score.s1–s5	array	[player1_games, player2_games] per set
score.s1_tb–s5_tb	array	Tiebreak score; only present if a tiebreak was played
credits_remaining	integer\|string	Credits left after this call. `"unlimited"` for subscription users

GET /match/tracker

Canlı maç izleyicisini tam render edilmiş bir HTML sayfası olarak döner. API key gerekmez — GET /match/scores yanıtındaki tracker_url'yi alıp doğrudan iframe'e gömün. API key'iniz son kullanıcılara hiç gösterilmez.

GET /api/v1/match/tracker Ücretsiz — API key gerekmez

İpucu: GET /match/scores'u sunucu tarafında çağırarak tracker_url'yi alın, ardından iframe'in src'ine atayın. Bu sayede API key'iniz sunucunuzda kalır, sayfa kaynağında görünmez.

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
match_id	Evet	—	`/matches` yanıtındaki maç kimliği
lang	Hayır	`en`	Yanıt dili: `en` `tr` `de` `ru`

Örnek istekler

# Step 1: call match/scores with your API key to get tracker_url
https://live-tennis-api.com/api/v1/match/scores?api_key=YOUR_KEY&match_id=16498578

# Step 2: embed the tracker_url from the response — no API key exposed
<iframe src="https://live-tennis-api.com/api/v1/match/tracker?match_id=16498578" width="800" height="600"></iframe>

# Direct access also works
https://live-tennis-api.com/api/v1/match/tracker?match_id=16498578&lang=de
                

curl "https://live-tennis-api.com/api/v1/match/tracker?match_id=16498578&lang=en" \
  --output tracker.html
                

// Step 1: fetch scores (server-side) — get tracker_url
const scores = await fetch('/api/scores?match_id=16498578').then(r => r.json());

// Step 2: embed tracker_url — API key never touches the browser
const iframe = document.createElement('iframe');
iframe.src    = scores.tracker_url;
iframe.width  = '800';
iframe.height = '600';
document.body.appendChild(iframe);
                

<?php
$url = 'https://live-tennis-api.com/api/v1/match/tracker'
      . '?api_key=YOUR_KEY&match_id=16498578&lang=en';

$html = file_get_contents($url);
echo $html;
                

import requests

resp = requests.get(
    'https://live-tennis-api.com/api/v1/match/tracker',
    params={
        'api_key': 'YOUR_KEY',
        'match_id': 16498578,
        'lang': 'en',
    }
)
with open('tracker.html', 'w') as f:
    f.write(resp.text)
                

Yanıt

Bu endpoint text/html döndürür — iframe'e gömmek için hazır tam bir HTML sayfası. JSON yanıt değildir.

GET /rankings

ATP, WTA, ATP Live veya WTA Live oyuncu sıralamalarını döndürür. 500 oyuncuya kadar tam liste sunucu tarafında önbelleğe alınır ve dilimlenir — ek kredi harcamadan sayfalamak için from ve limit kullanın.

GET /api/v1/rankings 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
type	Hayır	atp	Sıralama listesi: `atp`, `wta`, `atp_live` veya `wta_live`
from	Hayır	1	Başlangıç sıralama pozisyonu (1 tabanlı). Örn. `51` ile 51. sıradan başlar.
limit	Hayır	100	Döndürülecek oyuncu sayısı (varsayılan 100, maks 500).

Örnek istekler

# ATP top 100
https://live-tennis-api.com/api/v1/rankings?api_key=YOUR_KEY&type=atp&limit=100

# WTA positions 51–100
https://live-tennis-api.com/api/v1/rankings?api_key=YOUR_KEY&type=wta&from=51&limit=50
                

curl "https://live-tennis-api.com/api/v1/rankings?api_key=YOUR_KEY&type=atp&limit=100"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/rankings?api_key=YOUR_KEY&type=atp&limit=100'
);
const data = await res.json();
console.log(data.players);
                

<?php
$data = json_decode(file_get_contents(
  'https://live-tennis-api.com/api/v1/rankings?api_key=YOUR_KEY&type=atp&limit=100'
), true);
var_dump($data['players']);
                

import requests
data = requests.get(
    'https://live-tennis-api.com/api/v1/rankings',
    params={'api_key': 'YOUR_KEY', 'type': 'atp', 'limit': 100}
).json()
                

Yanıt

{
  "ranking_type": {
    "name":       "ATP Rankings",
    "type":       "atp",
    "gender":     "M",
    "updated_at": 1783990841,
    "total":      500
  },
  "from":     1,
  "limit":    100,
  "returned": 100,
  "has_more": true,
  "players": [
    {
      "position":           1,
      "position_change":    0,
      "previous_position":  1,
      "best_position":      1,
      "player_id":         206570,
      "name":              "Jannik Sinner",
      "short_name":        "J. Sinner",
      "country":           "IT",
      "country_name":      "Italy",
      "points":            13450,
      "previous_points":   13450,
      "tournaments_played":19,
      "photo":             "https://live-tennis-api.com/image/players/206570.png"
    },
    /* ... 99 more players */
  ],
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
ranking_type.total	integer	Total players in the full ranking (always 500)
ranking_type.updated_at	integer	Unix timestamp of the last rankings update
from	integer	Starting position of this response slice
has_more	boolean	`true` if more players exist beyond this slice — increment `from` by `limit` to paginate
position_change	integer	Positions gained (positive) or lost (negative) since the previous update
best_position	integer	Career best ranking position
previous_points	integer	Points from the previous ranking update
tournaments_played	integer	Tournaments counted toward the current ranking
credits_remaining	integer\|string	docs_f_credits_remaining

GET /tournament/details

Belirli bir sezon için turnuvanın temel bilgilerini döner — isim, zemin, ülke, şehir, ödül parası, çizelge büyüklüğü ve tarihler. Yıl seçimi için seasons dizisi ve SofaScore'un sağladığı ek alanlar için info_boxes dizisi de içerir.

GET /api/v1/tournament/details 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
tournament_id	Evet	—	SofaScore turnuva URL'sindeki turnuva ID'si (örn. ATP Challenger Lincoln için `23140`)
season_id	Hayır	en güncel	Sezon ID — belirli bir yıl için `GET /tournament/results`'daki `seasons[].id`'yi kullanın. Varsayılan: son sezon.
lang	Hayır	en	Yanıt dili: `en` `tr` `de` `ru`

Örnek istekler

https://live-tennis-api.com/api/v1/tournament/details?api_key=YOUR_KEY&tournament_id=2413
                

curl "https://live-tennis-api.com/api/v1/tournament/details?api_key=YOUR_KEY&tournament_id=2413"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/tournament/details?api_key=YOUR_KEY&tournament_id=2413'
);
const data = await res.json();
console.log(data.name, data.surface, data.prize_money);
                

<?php
$data = json_decode(file_get_contents(
  'https://live-tennis-api.com/api/v1/tournament/details?api_key=YOUR_KEY&tournament_id=2413'
), true);
echo $data['name'] . ' — ' . $data['surface'];
                

import requests
data = requests.get(
    'https://live-tennis-api.com/api/v1/tournament/details',
    params={'api_key': 'YOUR_KEY', 'tournament_id': 2413}
).json()
                

Yanıt

{
  "status":          "ok",
  "tournament_id":   2413,
  "season_id":       81901,
  "name":            "Bastad",
  "slug":            "bastad",
  "category":        "ATP",
  "gender":          "M",
  "surface":         "Red clay",
  "atp_points":      250,
  "number_of_sets":  3,
  "start_date":      "2026-07-07",
  "end_date":        "2026-07-13",
  "title_holder": {
    "id":      308084,
    "name":    "Luciano Darderi",
    "ranking": 18,
    "country": "IT",
    "photo":   "https://live-tennis-api.com/image/players/308084.png"
  },
  "logo":            "https://live-tennis-api.com/image/tournament/2413.png",
  "primary_color":   "#034ea2",
  "secondary_color": "#ffe37e",
  "seasons": [
    { "id": 81901, "year": "2026", "name": "ATP Bastad, Sweden Men Singles 2026" },
    { "id": 67378, "year": "2025", "name": "ATP Bastad, Sweden Men Singles 2025" }
  ],
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
name	string	Official tournament name
slug	string	URL-friendly tournament identifier
category	string	Tour category (ATP, WTA, Challenger, etc.)
gender	string	`M` (men) or `F` (women)
surface	string	Court surface, translated if `lang` is set
atp_points	integer\|null	Ranking points awarded for winning this tournament
number_of_sets	integer\|null	Sets per match (typically 3 for ATP/WTA, 5 for Grand Slams)
start_date / end_date	string\|null	Tournament dates in `YYYY-MM-DD` format
title_holder	object\|null	Defending champion — id, name, ranking, country, photo
logo	string	Tournament logo image URL
primary_color / secondary_color	string	Tournament brand colors as hex values
seasons	array	All available seasons — id, year, name
credits_remaining	integer\|string	docs_f_credits_remaining

GET /tournament/bracket

Bir turnuva sezonu için tam eleme çizelgesini döner — ana çizelge ve eleme turu. Her tur; oyuncuları, sıralamalarını ve kazanan bilgisini içerir. Yıl seçimi için GET /tournament/results'dan season_id alın.

GET /api/v1/tournament/bracket 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
tournament_id	Evet	—	SofaScore turnuva URL'sindeki turnuva ID'si (örn. ATP Challenger Lincoln için `23140`)
season_id	Hayır	en güncel	Sezon ID — belirli bir yıl için `GET /tournament/results`'daki `seasons[].id`'yi kullanın. Varsayılan: son sezon.

Örnek istekler

# Latest season (auto-detected)
https://live-tennis-api.com/api/v1/tournament/bracket?api_key=YOUR_KEY&tournament_id=23140

# Specific season
https://live-tennis-api.com/api/v1/tournament/bracket?api_key=YOUR_KEY&tournament_id=23140&season_id=89928
                

curl "https://live-tennis-api.com/api/v1/tournament/bracket?api_key=YOUR_KEY&tournament_id=23140&season_id=89928"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/tournament/bracket'
  + '?api_key=YOUR_KEY&tournament_id=23140&season_id=89928'
);
const data = await res.json();
console.log(data.draws);
                

<?php
$url = 'https://live-tennis-api.com/api/v1/tournament/bracket'
      . '?api_key=YOUR_KEY&tournament_id=23140&season_id=89928';
$data = json_decode(file_get_contents($url), true);
var_dump($data['draws']);
                

import requests
data = requests.get(
    'https://live-tennis-api.com/api/v1/tournament/bracket',
    params={'api_key': 'YOUR_KEY', 'tournament_id': 23140, 'season_id': 89928}
).json()
print(data['draws'])
                

Yanıt

{
  "status":        "ok",
  "tournament_id": 23140,
  "season_id":     89928,
  "seasons": [
    { "id": 89928, "year": "2026", "name": "ATP Challenger Lincoln 2026" },
    { "id": 80594, "year": "2025", "name": "ATP Challenger Lincoln 2025" }
  ],
  "draws": [
    {
      "name":   "2026 Lincoln, USA",
      "type":   "main",
      "rounds": [
        {
          "name":    "Round of 32",
          "order":   1,
          "matches": [
            {
              "block_id": 2612048,
              "event_id": 16514881,
              "finished": false,
              "player1":  { "id": 489715, "name": "Matthew Forbes",   "ranking": 939, "photo": "https://live-tennis-api.com/image/players/489715.png", "winner": false },
              "player2":  { "id": 408344, "name": "Sebastian Gorzny", "ranking": 966, "photo": "https://live-tennis-api.com/image/players/408344.png", "winner": false }
            }
          ]
        },
        { "name": "Round of 16", "order": 2, "matches": [/* 8 matches */] },
        { "name": "Quarterfinal",  "order": 3, "matches": [/* 4 matches */] },
        { "name": "Semifinal",     "order": 4, "matches": [/* 2 matches */] },
        { "name": "Final",         "order": 5, "matches": [/* 1 match  */] }
      ]
    },
    { "name": "2026 Lincoln, USA, Qualifying", "type": "qualifying", "rounds": [/* same structure */] }
  ],
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
seasons	array	All available seasons — `id`, `year`, `name`. Use `season_id` param to switch year.
draws[].type	string	`"main"` or `"qualifying"`
draws[].rounds[].name	string	Round label — e.g. `"Round of 32"`, `"Quarterfinal"`, `"Final"`
draws[].rounds[].order	integer	Round order starting from 1 (1 = earliest round)
matches[].event_id	integer\|null	Match ID — use with `GET /match/scores`; `null` if not yet scheduled
matches[].finished	boolean	Whether the match has been played
matches[].player1 / player2	object\|null	`id`, `name`, `ranking`, `photo`, `winner` (boolean); `null` if slot is empty (BYE or not yet filled)
credits_remaining	integer\|string	Credits left after this call

GET /tournament/results

Bir turnuva sezonu için tamamlanmış ve yaklaşan maçları ve tüm sezonların listesini döner. Mümkünse oyuncu sıralama numarasını içerir.

GET /api/v1/tournament/results 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
tournament_id	Evet	—	SofaScore turnuva URL'sindeki turnuva ID'si (örn. ATP Challenger Lincoln için `23140`)
season_id	Hayır	en güncel	Sezon ID — belirli bir yıl için `GET /tournament/results`'daki `seasons[].id`'yi kullanın. Varsayılan: son sezon.
lang	Hayır	`en`	Yanıt dili: `en` `tr` `de` `ru`

Örnek istekler

# Current season results (auto-detected)
https://live-tennis-api.com/api/v1/tournament/results?api_key=YOUR_KEY&tournament_id=23140

# Specific season + language
https://live-tennis-api.com/api/v1/tournament/results?api_key=YOUR_KEY&tournament_id=23140&season_id=89928&lang=tr
                

curl "https://live-tennis-api.com/api/v1/tournament/results?api_key=YOUR_KEY&tournament_id=23140&season_id=89928&lang=en"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/tournament/results'
  + '?api_key=YOUR_KEY&tournament_id=23140&season_id=89928&lang=en'
);
const data = await res.json();
console.log(data.seasons, data.past_matches, data.upcoming_matches);
                

<?php
$url = 'https://live-tennis-api.com/api/v1/tournament/results'
      . '?api_key=YOUR_KEY&tournament_id=23140&season_id=89928&lang=en';
$data = json_decode(file_get_contents($url), true);
var_dump($data['past_matches']);
                

import requests
data = requests.get(
    'https://live-tennis-api.com/api/v1/tournament/results',
    params={'api_key': 'YOUR_KEY', 'tournament_id': 23140, 'season_id': 89928, 'lang': 'en'}
).json()
print(data['seasons'])
                

Yanıt

{
  "status":        "ok",
  "tournament_id": 23140,
  "season_id":     89928,
  "seasons": [
    { "id": 89928, "year": "2026", "name": "ATP Challenger Lincoln (NE), USA Men Singles 2026" },
    { "id": 80594, "year": "2025", "name": "ATP Challenger Lincoln (NE), USA Men Singles 2025" },
    { "id": 64754, "year": "2024", "name": "ATP Challenger Rome, USA Men Singles 2024" }
  ],
  "past_matches": [
    {
      "id":              16498578,
      "start_timestamp": 1783967700,
      "status":          "finished",
      "player1": { "id": 217464, "name": "Rio Noguchi", "country": "JP", "ranking": 222, "seed": null, "photo": "https://live-tennis-api.com/image/players/217464.png" },
      "player2": { "id": 202181, "name": "Charles Broom", "country": "GB", "ranking": 283, "seed": null, "photo": "https://live-tennis-api.com/image/players/202181.png" },
      "round":  "Round of 32",
      "surface": "Hardcourt outdoor",
      "score":  { "sets_won": [2, 1], "s1": [6, 2], "s2": [4, 6], "s3": [7, 5] },
      "winner": "player1"
    }
  ],
  "upcoming_matches": [ /* same structure, score will be empty */ ],
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
seasons	array	All available seasons for this tournament — use `id` as `season_id` for year selection
seasons[].year	string	Year string — e.g. `"2026"`, `"2025"`
past_matches	array	Completed matches, most recent first
upcoming_matches	array	Scheduled but not yet played matches
player1/2.seed	integer\|null	Player seeding in this tournament; `null` for unseeded players
round	string\|null	Round label — e.g. `"Round of 32"`, `"Final"`
surface	string\|null	Court surface
credits_remaining	integer\|string	Credits left after this call

GET /player/profile

Oyuncunun tam biyografisini döner — sıralama, el tercihi, boy, kilo, doğum tarihi, ödül parası ve fotoğraf.

GET /api/v1/player/profile 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
player_id	Evet	—	SofaScore oyuncu URL'sindeki oyuncu ID'si (örn. Nicolas Arseneault için `457262`)
lang	Hayır	en	Yanıt dili: `en` `tr` `de` `ru`

Örnek istekler

https://live-tennis-api.com/api/v1/player/profile?api_key=YOUR_KEY&player_id=457262
                

curl "https://live-tennis-api.com/api/v1/player/profile?api_key=YOUR_KEY&player_id=457262"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/player/profile?api_key=YOUR_KEY&player_id=457262'
);
const data = await res.json();
console.log(data.player);
                

<?php
$data = json_decode(file_get_contents(
  'https://live-tennis-api.com/api/v1/player/profile?api_key=YOUR_KEY&player_id=457262'
), true);
                

import requests
data = requests.get(
    'https://live-tennis-api.com/api/v1/player/profile',
    params={'api_key': 'YOUR_KEY', 'player_id': 457262}
).json()
                

Yanıt

{
  "status": "ok",
  "player": {
    "id":             457262,
    "name":           "Nicolas Arseneault",
    "short_name":     "N. Arseneault",
    "country":        { "code": "CA", "name": "Canada" },
    "gender":         "M",
    "ranking":        768,
    "hand":           "left-handed",
    "height":         1.83,
    "weight":         77,
    "birthdate":      "2007-01-18",
    "age":            19,
    "birthplace":     "Richmond Hill, Canada",
    "prize_current":  1505,
    "prize_total":    66695,
    "photo":          "https://live-tennis-api.com/image/players/457262.png"
  },
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
player.ranking	integer\|null	Current ATP/WTA ranking
player.hand	string\|null	Playing hand — translated with `lang` param
player.height	float\|null	Height in metres
player.weight	integer\|null	Weight in kilograms
player.prize_current	integer\|null	Prize money earned this season (EUR)
player.prize_total	integer\|null	Career prize money total (EUR)
credits_remaining	integer\|string	docs_f_credits_remaining

GET /player/matches

Oyuncunun tüm turnuvalardaki son ve yaklaşan maçlarını sayfalı olarak döner. type=singles veya type=doubles ile filtreleyin.

GET /api/v1/player/matches 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
player_id	Evet	—	SofaScore oyuncu URL'sindeki oyuncu ID'si (örn. Nicolas Arseneault için `457262`)
page	Hayır	0	Sonuç sayfası — 0 = en son 30 maç, 1 = önceki 30 maç vb.
type	Hayır	all	Maç türüne göre filtrele: `all` (varsayılan), `singles` veya `doubles`
lang	Hayır	en	Yanıt dili: `en` `tr` `de` `ru`

Yanıt

{
  "status":     "ok",
  "player_id":  457262,
  "page":          0,
  "has_next_page": true,
  "next_page":     1,
  "past_matches": [
    {
      "id":              14876875,
      "start_timestamp": 1760379000,
      "type":            "singles",
      "status":          "finished",
      "result":          "W",
      "player":   { "id": 457262, "name": "Nicolas Arseneault", "ranking": 780, "country": "CA", "photo": "https://live-tennis-api.com/image/players/457262.png" },
      "opponent": { "id": 95259,  "name": "Strong Kirchheimer",   "ranking": 660,  "country": "US", "photo": "https://live-tennis-api.com/image/players/95259.png" },
      "tournament": { "id": 23140, "name": "ATP Challenger Lincoln (NE)", "category": "Challenger" },
      "season":     { "id": 80594, "year": "2025" },
      "round":      "Qualification Final",
      "surface":    "Hardcourt outdoor",
      "score": { "sets": [2, 0], "s1": [6, 3], "s2": [7, 5] }
    }
  ],
  "upcoming_matches": [],
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
page	integer	Current page — 30 matches per page
has_next_page	boolean	`true` if a next page exists; `false` when you've reached the last page
next_page	integer\|null	Page number to pass for the next request; `null` on the last page
type	string	`all` (default), `singles`, or `doubles`
result	string\|null	`"W"` (win) or `"L"` (loss); `null` for upcoming matches
opponent.members	array\|null	Doubles only — lists both players in the opponent pair
surface	string\|null	Translated with `lang` param
round	string\|null	Translated with `lang` param
upcoming_matches	array	Only populated on page 0
credits_remaining	integer\|string	docs_f_credits_remaining

GET /player/statistics

Oyuncunun belirli bir sezon yılı için genel ve zemine göre galibiyet/yenilgi istatistiklerini döner. En fazla son 60 maç kapsanır.

GET /api/v1/player/statistics 1 credit

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
player_id	Evet	—	SofaScore oyuncu URL'sindeki oyuncu ID'si (örn. Nicolas Arseneault için `457262`)
season_year	Hayır	mevcut yıl	İstatistik hesaplanacak yıl (örn. `2026`). Varsayılan: mevcut yıl.
lang	Hayır	en	Yanıt dili: `en` `tr` `de` `ru`

Yanıt

{
  "status":      "ok",
  "player": { /* same as GET /player/profile */ },
  "season_year": "2026",
  "singles": {
    "played":   18,
    "wins":     11,
    "losses":   7,
    "win_rate": 61.1,
    "by_surface": {
      "hardcourt": { "played": 12, "wins": 8, "losses": 4 },
      "clay":      { "played": 4,  "wins": 2, "losses": 2 },
      "grass":     { "played": 2,  "wins": 1, "losses": 1 }
    }
  },
  "doubles": { "played": 6, "wins": 3, "losses": 3, "win_rate": 50.0 },
  "recent_form": ["W", "W", "L", "W", "L", "W", "W", "W", "L", "W"],
  "credits_remaining": 49
}

Alan referansı

Alan	Tür	Açıklama
season_year	string	The year the statistics are filtered to (defaults to current year)
singles.by_surface	object	W/L breakdown per surface — keys: `hardcourt`, `clay`, `grass`, `carpet`
recent_form	string[]	Last 10 singles match results, newest first — `"W"` or `"L"`
credits_remaining	integer\|string	docs_f_credits_remaining

GET /webhook/register

Yeni bir webhook endpointi kaydeder. Abone olunan bir olay gerçekleştiğinde URL'nize JSON içerikli bir POST isteği gönderilir. Hesap başına en fazla 10 aktif webhook. Ücretsiz — kredi tüketmez.

GET /api/v1/webhook/register Ücretsiz — API key gerekmez

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
url	Evet	—	POST isteklerini alacak, kamuya açık bir `http` veya `https` URL'si
events	Hayır	all	Abone olunacak olay türlerinin virgülle ayrılmış listesi (ör. `match.start,score.update`). Boş bırakılırsa tüm olaylara abone olunur.
secret	Hayır	—	İsteğe bağlı gizli anahtar — ayarlandığında her istekte doğrulama için `X-Webhook-Signature: sha256=<hmac>` başlığı eklenir

Kullanılabilir olaylar

Olay	Açıklama
match.start	Maç başladı (`notstarted` → `inprogress`)
match.finish	Maç final skoruyla tamamlandı
match.postponed	Maç ertelendi
match.cancelled	Maç iptal edildi
score.update	Set skoru değişti veya oyun içi puan güncellendi (15 / 30 / 40 / A). Sayım sürecindeyken `current_game` alanı eklenir.
period.start	Yeni bir set başladı
period.end	Bir set sona erdi

Örnek istekler

https://live-tennis-api.com/api/v1/webhook/register?api_key=YOUR_KEY&url=https://yourapp.com/hook&events=match.start,match.finish,score.update
                

curl "https://live-tennis-api.com/api/v1/webhook/register?api_key=YOUR_KEY&url=https://yourapp.com/hook&events=match.start,match.finish"
                

const res = await fetch(
  'https://live-tennis-api.com/api/v1/webhook/register?api_key=YOUR_KEY' +
  '&url=https://yourapp.com/hook&events=match.start,match.finish'
);
const data = await res.json();
console.log(data.webhook_id);
                

<?php
$data = json_decode(file_get_contents(
  'https://live-tennis-api.com/api/v1/webhook/register?api_key=YOUR_KEY'
  . '&url=https://yourapp.com/hook&events=match.start,match.finish'
), true);
echo $data['webhook_id'];
                

import requests
data = requests.get(
    'https://live-tennis-api.com/api/v1/webhook/register',
    params={'api_key': 'YOUR_KEY', 'url': 'https://yourapp.com/hook', 'events': 'match.start,match.finish'}
).json()
                

Yanıt

{
  "status":     "ok",
  "webhook_id": 12,
  "url":        "https://yourapp.com/hook",
  "events":     ["match.start", "match.finish", "score.update"],
  "secret":     null,
  "credits_remaining": 49
}

Webhook içeriği

Endpoint'iniz Content-Type: application/json ile bir POST isteği ve aşağıdaki gövdeyi alır:

Every event follows the same envelope: event, timestamp, a match object (always present), and an event-specific data object. Click an event below to see its example response.

⚠️ Önemli Güvenlik Uyarısı Webhook bildirimleri sistemimizden 45.94.4.69 IP adresi üzerinden gönderilmektedir. Ek güvenlik sağlamak amacıyla sunucunuzda (Firewall tarafında) webhook endpoint'inize gelen istekleri sadece bu IP adresine izin verecek şekilde kısıtlayabilirsiniz.

GET /webhook/list

API anahtarınıza kayıtlı tüm aktif webhook'ları döndürür. Ücretsiz — kredi tüketmez.

GET /api/v1/webhook/list Ücretsiz — API key gerekmez

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız

Örnek istekler

https://live-tennis-api.com/api/v1/webhook/list?api_key=YOUR_KEY
curl "https://live-tennis-api.com/api/v1/webhook/list?api_key=YOUR_KEY"

const data = await (await fetch('https://live-tennis-api.com/api/v1/webhook/list?api_key=YOUR_KEY')).json();
                
<?php
$data = json_decode(file_get_contents('https://live-tennis-api.com/api/v1/webhook/list?api_key=YOUR_KEY'), true);
                
import requests
data = requests.get('https://live-tennis-api.com/api/v1/webhook/list', params={'api_key': 'YOUR_KEY'}).json()

Yanıt

{
  "status":   "ok",
  "count":    2,
  "webhooks": [
    {
      "webhook_id": 12,
      "url":        "https://yourapp.com/hook",
      "secret":     null,
      "events":     ["match.start", "score.update"],
      "created_at": "2026-07-14 10:32:00"
    }
  ],
  "credits_remaining": 49
}

GET /webhook/delete

Bir webhook'u ID'sine göre devre dışı bırakır. Ücretsiz — kredi tüketmez.

GET /api/v1/webhook/delete Ücretsiz — API key gerekmez

Parametreler

Parametre	Zorunlu	Varsayılan	Açıklama
api_key	Evet	—	API anahtarınız
webhook_id	Evet	—	`GET /webhook/register` veya `GET /webhook/list` ile dönen webhook ID'si

Örnek istekler

https://live-tennis-api.com/api/v1/webhook/delete?api_key=YOUR_KEY&webhook_id=12
curl "https://live-tennis-api.com/api/v1/webhook/delete?api_key=YOUR_KEY&webhook_id=12"

const data = await (await fetch('https://live-tennis-api.com/api/v1/webhook/delete?api_key=YOUR_KEY&webhook_id=12')).json();
                
<?php
$data = json_decode(file_get_contents('https://live-tennis-api.com/api/v1/webhook/delete?api_key=YOUR_KEY&webhook_id=12'), true);
                
import requests
data = requests.get('https://live-tennis-api.com/api/v1/webhook/delete', params={'api_key': 'YOUR_KEY', 'webhook_id': 12}).json()

Yanıt

{
  "status":     "ok",
  "webhook_id": 12,
  "deleted":    true,
  "credits_remaining": 49
}