Home · APIs · Gaming · Lichess player

Lichess player API

One request, one key: POST /v1/gaming/lichess/player. The sample below is a real response captured 20 November 2026, shortened for display (long text cut, lists cut to three items); it is not invented.

Price

1 credit a call. One call is about $0.0098 and 1,000 calls are about $9.80 at the smallest paid plan's rate.Formula A call that comes back empty is not charged.

Try it free

Runs one real call with the sample input below. No key and no sign-up; a few runs a day per visitor.

{
  "username": "DrNykterstein"
}

What it returns

FieldTypeValue in the sample
platformstringlichess
usernamestringDrNykterstein
titlestringGM
patronbooleantrue
onlinebooleanfalse
ultra_bulletobject{"rating":2406,"games":92,"progress":-7,"provisional":true}
bulletobject{"rating":3263,"games":9585,"progress":23,"provisional":false}
blitzobject{"rating":3194,"games":609,"progress":70,"provisional":true}
rapidobject{"rating":2500,"games":0,"progress":0,"provisional":true}
classicalobject{"rating":2500,"games":0,"progress":0,"provisional":true}
correspondenceobject{"rating":1500,"games":0,"progress":0,"provisional":true}
total_gamesnumber10455
total_ratednumber10440
total_winsnumber7212
total_lossesnumber2409
total_drawsnumber834
play_time_hoursnumber325.1
created_datestring2018-12-06
last_seen_datestring2026-11-15
lichess_urlstringhttps://lichess.org/@/DrNykterstein
time_controls_glossaryobject{"ultra_bullet":"Under 30 seconds per game","bullet":"1-2 minutes per game","blitz":"3-5 minutes per game",...
credits_usednumber1
latency_msnumber276

Sample response (20 November 2026)

{
  "platform": "lichess",
  "username": "DrNykterstein",
  "title": "GM",
  "patron": true,
  "online": false,
  "ultra_bullet": {
    "rating": 2406,
    "games": 92,
    "progress": -7,
    "provisional": true
  },
  "bullet": {
    "rating": 3263,
    "games": 9585,
    "progress": 23,
    "provisional": false
  },
  "blitz": {
    "rating": 3194,
    "games": 609,
    "progress": 70,
    "provisional": true
  },
  "rapid": {
    "rating": 2500,
    "games": 0,
    "progress": 0,
    "provisional": true
  },
  "classical": {
    "rating": 2500,
    "games": 0,
    "progress": 0,
    "provisional": true
  },
  "correspondence": {
    "rating": 1500,
    "games": 0,
    "progress": 0,
    "provisional": true
  },
  "puzzle": null,
  "total_games": 10455,
  "total_rated": 10440,
  "total_wins": 7212,
  "total_losses": 2409,
  "total_draws": 834,
  "completion_rate": null,
  "play_time_hours": 325.1,
  "created_date": "2018-12-06",
  "last_seen_date": "2026-11-15",
  "country": null,
  "bio": null,
  "fide_rating": null,
  "lichess_url": "https://lichess.org/@/DrNykterstein",
  "time_controls_glossary": {
    "ultra_bullet": "Under 30 seconds per game",
    "bullet": "1-2 minutes per game",
    "blitz": "3-5 minutes per game",
    "rapid": "8-25 minutes per game",
    "classical": "25+ minutes per game",
    "correspondence": "Days per move"
  },
  "errors": [],
  "credits_used": 1,
  "latency_ms": 276
}

Measured on that call: 833 ms.

Code

curl -X POST https://api.foxapis.com/v1/gaming/lichess/player \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"DrNykterstein"}'
import requests

r = requests.post(
    "https://api.foxapis.com/v1/gaming/lichess/player",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={"username":"DrNykterstein"},
)
print(r.json())
const r = await fetch("https://api.foxapis.com/v1/gaming/lichess/player", {
  method: "POST",
  headers: { "Authorization": "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({"username":"DrNykterstein"}),
});
console.log(await r.json());

n8n (HTTP Request node: paste it into a workflow)

{
  "nodes": [
    {
      "name": "Lichess player",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4,
      "position": [
        0,
        0
      ],
      "parameters": {
        "method": "POST",
        "url": "https://api.foxapis.com/v1/gaming/lichess/player",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer YOUR_KEY"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "{\"username\":\"DrNykterstein\"}"
      }
    }
  ],
  "connections": {}
}

Assistants (Claude, ChatGPT, Cursor)

Connect the FoxAPIs server once; the tools it offers are listed on the MCP page.

claude mcp add --transport http foxapis https://foxapis.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Errors and limits

Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.

Get my free key

Same category: Gaming · all APIs

How we calculate

Data: scripts/data/endpoint-credits.json and plans.json, 2026-11-20. Every other figure on this page is copied from the record, not calculated by us.