curl --request GET \
--url https://padelapi.org/api/players/{player}/rankings \
--header 'Authorization: Bearer <token>'import requests
url = "https://padelapi.org/api/players/{player}/rankings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://padelapi.org/api/players/{player}/rankings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://padelapi.org/api/players/{player}/rankings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://padelapi.org/api/players/{player}/rankings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://padelapi.org/api/players/{player}/rankings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://padelapi.org/api/players/{player}/rankings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": 123,
"self": "<string>",
"name": "<string>",
"category": "men",
"nationality": "<string>",
"type": "official",
"ranking": 123,
"ranking_diff": 123,
"points": 123,
"points_diff": 123,
"date": "<string>",
"connections": {
"rankings": "<string>"
}
}
]{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>",
"errors": {}
}List Player Rankings
Retrieve every ranking published for a player — multiple types (official,
race, elo) — as the current snapshot or as a historical series.
Without after_date/before_date it returns the latest entry for each ranking
type. With after_date and/or before_date it returns the chronological series
of weekly snapshots within that range, so you can plot ranking evolution and spot
peaks and lows.
On the free plan, only the latest weekly snapshot is visible: ranking values
from older snapshots return hidden_free_plan. Paid plans include the full
ranking history.
curl --request GET \
--url https://padelapi.org/api/players/{player}/rankings \
--header 'Authorization: Bearer <token>'import requests
url = "https://padelapi.org/api/players/{player}/rankings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://padelapi.org/api/players/{player}/rankings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://padelapi.org/api/players/{player}/rankings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://padelapi.org/api/players/{player}/rankings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://padelapi.org/api/players/{player}/rankings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://padelapi.org/api/players/{player}/rankings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": 123,
"self": "<string>",
"name": "<string>",
"category": "men",
"nationality": "<string>",
"type": "official",
"ranking": 123,
"ranking_diff": 123,
"points": 123,
"points_diff": 123,
"date": "<string>",
"connections": {
"rankings": "<string>"
}
}
]{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>",
"errors": {}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The player ID
Query Parameters
Start date of the historical series in YYYY-MM-DD format.
End date of the historical series in YYYY-MM-DD format.
Filter by ranking type. Omit to return official, race and elo.
official, race, elo Response
Unique identifier of the ranked player.
Path to the player's profile, relative to https://padelapi.org.
Full name of the player, without accents or special characters.
Competition category this ranking belongs to. Men and women are ranked separately, so positions repeat across categories.
men, women ISO 3166-1 alpha-2 country code of the player, uppercase.
Which ranking list this entry belongs to. A player has one entry per type, so filter on this field when plotting a single series. The ranking and points on the player resource mirror the current official values. On the elo list points is the rating the player carried into that week, so it can differ from the elo on the player resource, which moves with every match played. Only players with at least 5 rated matches in the last 12 months are ranked on this list.
official, race, elo Position in the ranking. On the free plan, only a player's current entry is visible; older snapshots return hidden_free_plan. Paid plans include the full ranking history.
Positions gained or lost since the player's previous entry. A player missing from the preceding snapshots re-enters with no movement, instead of a diff spanning the whole absence. On the free plan, only a player's current entry is visible; older snapshots return hidden_free_plan.
Ranking points, or the Elo rating when type is elo. On the free plan, only a player's current entry is visible; older snapshots return hidden_free_plan. Paid plans include the full ranking history.
Points, or Elo rating points, gained or lost since the player's previous entry. A player missing from the preceding snapshots re-enters with no movement, instead of a diff spanning the whole absence. On the free plan, only a player's current entry is visible; older snapshots return hidden_free_plan.
Monday of the ISO week this snapshot belongs to, as YYYY-MM-DD. Snapshots are weekly, so this is the date the entry took effect rather than the day it was published.
Related endpoints for this ranking entry.
Show child attributes
Show child attributes