export_user_games
Download a user's Lichess games with customizable filters, including timestamps, opponents, game types, and analysis details, for comprehensive chess data export.
Instructions
Export all games of a user
Input Schema
Name | Required | Description | Default |
---|---|---|---|
accuracy | No | Include accuracy | |
analysed | No | Only games with or without computer analysis | |
clocks | No | Include clock comments | |
color | No | Only games played as this color | |
evals | No | Include analysis | |
finished | No | Include finished games | |
lastFen | No | Include last position FEN | |
literate | No | Include textual annotations | |
max | No | Maximum number of games to download | |
moves | No | Include moves | |
ongoing | No | Include ongoing games | |
opening | No | Include opening | |
perfType | No | Only games in these speeds or variants | |
rated | No | Only rated (true) or casual (false) games | |
since | No | Download games played since timestamp | |
sort | No | Sort order of games | dateDesc |
tags | No | Include tags | |
until | No | Download games played until timestamp | |
username | Yes | The username | |
vs | No | Only games against this opponent |
Input Schema (JSON Schema)
{
"properties": {
"accuracy": {
"default": false,
"description": "Include accuracy",
"type": "boolean"
},
"analysed": {
"description": "Only games with or without computer analysis",
"type": "boolean"
},
"clocks": {
"default": false,
"description": "Include clock comments",
"type": "boolean"
},
"color": {
"description": "Only games played as this color",
"enum": [
"white",
"black"
],
"type": "string"
},
"evals": {
"default": false,
"description": "Include analysis",
"type": "boolean"
},
"finished": {
"default": true,
"description": "Include finished games",
"type": "boolean"
},
"lastFen": {
"default": false,
"description": "Include last position FEN",
"type": "boolean"
},
"literate": {
"default": false,
"description": "Include textual annotations",
"type": "boolean"
},
"max": {
"description": "Maximum number of games to download",
"type": "number"
},
"moves": {
"default": true,
"description": "Include moves",
"type": "boolean"
},
"ongoing": {
"default": false,
"description": "Include ongoing games",
"type": "boolean"
},
"opening": {
"default": false,
"description": "Include opening",
"type": "boolean"
},
"perfType": {
"description": "Only games in these speeds or variants",
"enum": [
"ultraBullet",
"bullet",
"blitz",
"rapid",
"classical",
"correspondence",
"chess960",
"crazyhouse",
"antichess",
"atomic",
"horde",
"kingOfTheHill",
"racingKings",
"threeCheck"
],
"type": "string"
},
"rated": {
"description": "Only rated (true) or casual (false) games",
"type": "boolean"
},
"since": {
"description": "Download games played since timestamp",
"type": "number"
},
"sort": {
"default": "dateDesc",
"description": "Sort order of games",
"enum": [
"dateAsc",
"dateDesc"
],
"type": "string"
},
"tags": {
"default": true,
"description": "Include tags",
"type": "boolean"
},
"until": {
"description": "Download games played until timestamp",
"type": "number"
},
"username": {
"description": "The username",
"type": "string"
},
"vs": {
"description": "Only games against this opponent",
"type": "string"
}
},
"required": [
"username"
],
"type": "object"
}