Rating API

Power your club's app, screens or site with live PadelRank ratings.

Quick start

Authenticate every request with your API key, either an Authorization: Bearer header or a ?key= query param.

curl "function(){throw Error("Attempted to call RATING_API_BASE() from the server but RATING_API_BASE is on the client. It's not possible to invoke a client function from the server, it can only be rendered as a Component or passed to props of a Client Component.")}/v1/player?username=demoplayer" \
  -H "Authorization: Bearer prk_your_key_here"

Endpoints

Base URL: https://us-central1-paddlerank-app.cloudfunctions.net/ratingApi

GET/v1/player?username=<username>
A single player's rating, reliability, matches and location.
GET/v1/rankings?country=<ISO2>&limit=<1-100>
Top players, globally or by country (ISO 3166 alpha-2).

Example response

{
  "player": {
    "username": "demoplayer",
    "name": "Demo Player",
    "rating": 18,
    "reliability": 72,
    "matches": 24,
    "country": "ES",
    "city": "Madrid"
  }
}

Your API keys

Create a key to start. The full key is shown once, store it somewhere safe.

Loading…