HTTP API
Lichess exposes a RESTish HTTP/JSON API that you are welcome to use. Read the HTTP API documentation.
Embed Lichess TV in your site
Add the following HTML to your site:
Parameters:
- theme: brown, wood, wood2, wood3, wood4, maple, maple2, horsey, leather, blue, blue2, blue3, canvas, blue-marble, ic, green, marble, green-plastic, olive, grey, metal, newspaper, purple, purple-diag, pink
- pieceSet: cburnett, merida, alpha, pirouetti, chessnut, chess7, reillycraig, companion, riohacha, kosal, leipzig, fantasy, spatial, celtic, california, caliente, pixel, maestro, fresca, cardinal, gioco, tatiana, staunty, cooke, monarchy, governor, dubrovny, icpieces, mpchess, kiwen-suwi, horsey, anarcandy, shapes, letter, disguised
- bg: light, dark, system
You can also show the channel for a specific variant or time control by adding the channel key to the URL, corresponding to the channels available at lichess.org/tv. If not included, the top rated game will be shown.
Embed the daily puzzle in your site
Add the following HTML to your site:
Parameters:
- theme: brown, wood, wood2, wood3, wood4, maple, maple2, horsey, leather, blue, blue2, blue3, canvas, blue-marble, ic, green, marble, green-plastic, olive, grey, metal, newspaper, purple, purple-diag, pink
- pieceSet: cburnett, merida, alpha, pirouetti, chessnut, chess7, reillycraig, companion, riohacha, kosal, leipzig, fantasy, spatial, celtic, california, caliente, pixel, maestro, fresca, cardinal, gioco, tatiana, staunty, cooke, monarchy, governor, dubrovny, icpieces, mpchess, kiwen-suwi, horsey, anarcandy, shapes, letter, disguised
- bg: light, dark, system
The text is automatically translated to your visitor's language.
Alternatively, you can post the puzzle in your slack workspace.
Embed a chess analysis in your site
Create a study, then click the share button to get the HTML code for the current chapter.
Parameters:
- theme: brown, wood, wood2, wood3, wood4, maple, maple2, horsey, leather, blue, blue2, blue3, canvas, blue-marble, ic, green, marble, green-plastic, olive, grey, metal, newspaper, purple, purple-diag, pink
- pieceSet: cburnett, merida, alpha, pirouetti, chessnut, chess7, reillycraig, companion, riohacha, kosal, leipzig, fantasy, spatial, celtic, california, caliente, pixel, maestro, fresca, cardinal, gioco, tatiana, staunty, cooke, monarchy, governor, dubrovny, icpieces, mpchess, kiwen-suwi, horsey, anarcandy, shapes, letter, disguised
- bg: light, dark, system
The text is automatically translated to your visitor's language.
Embed a chess game in your site
On a game analysis page, click the FEN & PGN tab at the bottom, then "Embed in your website".
Parameters:
- theme: brown, wood, wood2, wood3, wood4, maple, maple2, horsey, leather, blue, blue2, blue3, canvas, blue-marble, ic, green, marble, green-plastic, olive, grey, metal, newspaper, purple, purple-diag, pink
- pieceSet: cburnett, merida, alpha, pirouetti, chessnut, chess7, reillycraig, companion, riohacha, kosal, leipzig, fantasy, spatial, celtic, california, caliente, pixel, maestro, fresca, cardinal, gioco, tatiana, staunty, cooke, monarchy, governor, dubrovny, icpieces, mpchess, kiwen-suwi, horsey, anarcandy, shapes, letter, disguised
- bg: light, dark, system
The text is automatically translated to your visitor's language.
Embed a broadcast in your site
On a broadcast page, select the embed iframe code, then optionally add query parameters to customize the appearance.
Parameters:
- theme: brown, wood, wood2, wood3, wood4, maple, maple2, horsey, leather, blue, blue2, blue3, canvas, blue-marble, ic, green, marble, green-plastic, olive, grey, metal, newspaper, purple, purple-diag, pink
- pieceSet: cburnett, merida, alpha, pirouetti, chessnut, chess7, reillycraig, companion, riohacha, kosal, leipzig, fantasy, spatial, celtic, california, caliente, pixel, maestro, fresca, cardinal, gioco, tatiana, staunty, cooke, monarchy, governor, dubrovny, icpieces, mpchess, kiwen-suwi, horsey, anarcandy, shapes, letter, disguised
- bg: light, dark, system
The text is automatically translated to your visitor's language.