Skip to content

Add Filter for Standard Starting Position in User Game Export API #266

@jassler

Description

@jassler

The User Game Export API (https://lichess.org/api/games/user/{username}) currently lacks an option to filter games based on the starting position. It would be helpful to have a query parameter to distinguish between games that start from the standard chess position and games with custom starting positions.

Current Behavior

There is no way to differentiate games that start from a standard position and those which start from a custom position.

Expected Behavior

A new query parameter, such as startingPosition or fromPosition, can be used to filter games starting from the standard position.

Alternatively, include a way to filter starting positions in perfType, which currently allows us to filter for chess variants such as "chess960", "crazyhouse", etc. The variant already displays [Variant "From Position"]. This would make it a little more consistent.

Proposed API call

https://lichess.org/api/games/user/{username}?perfType="blitz,fromPosition"

Returns all blitz games that did not start in the standard position.

Use Case

I often give my students positions as exercises from which they have to win or draw the computer. I’d like to be able to filter and find those games more easily.

Vice versa, it’d probably also be useful to reliably receiving games from normal starting positions without having to manually filter out those that are not.

Thank you for considering this request.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions