Lanyard

About Lanyard

Lanyard is a service that exposes a user's live Discord presence and activity data through a RESTful API and WebSocket. Once a user joins the associated Discord server, their presence becomes available at an API endpoint keyed to their Discord user ID, returning data such as online status, current activities, and Spotify listening information (track, artist, album, timestamps).

The service also functions as a globally accessible realtime key-value store, which can be updated via the Lanyard Discord bot or the Lanyard API. Users can consume the hosted API without deploying anything themselves, or self-host it using the provided Docker setup, which requires some configuration.

Lanyard is aimed at developers who want to display Discord presence or activity data on personal websites, GitHub profiles, or other applications. A community ecosystem of wrapper libraries and integrations exists for multiple languages and frameworks, including React, Vue, Svelte, Go, Python, Dart, and Deno, along with tools such as a GraphQL port and an MCP server.

Key features

• Exposes live Discord presence and activity data via a REST API endpoint
• Provides a WebSocket for real-time presence updates
• Acts as a globally-accessible realtime key-value (KV) store
• KV store updatable via the Lanyard Discord bot or the Lanyard API
• No self-hosting required to use the API, but Docker self-hosting is supported
• Supports subscribing to a single user, multiple users, or every user's presence over the socket

Frequently asked questions