Report the authenticated Backloggd account, whether writes are enabled, and the current rate-limit state. Use this first if you are unsure the server is set up.

Search Backloggd's game catalogue by title. Returns id, slug, year, platforms and category. Set include_my_status to also report your own rating and shelf for each hit, which costs one extra request for the whole result set.

Full metadata for one game — description, genres, platforms, developers, release date and the site-wide average rating — plus your own log entry for it.

Your complete log for one game: shelf, rating, like state, playtime, and every playthrough with its review and dates.

Given a list of game names, report where each one sits in your Backloggd: its shelf (played / playing / backlog / wishlist / none), completion status, your rating, and which of your custom lists contain it. Built for questions like 'here are 20 games, which do I already have?'. Names that match no game are reported as not_found rather than failing the batch.

Report every one of your custom lists and whether it contains this game. Returns the list ids needed by add_game_to_lists.

Search a user's library with Backloggd's full filter grammar. Defaults to your own. This is the main discovery tool: combine a shelf with a release platform, genre, year, completion status or rating, and sort by anything including how long games take to finish.

Examples: shelf='backlog' + release_platform='PS5' answers 'what do I have that runs on PS5'; sort='shuffle' picks at random; sort='avg-finish-time' ranks by how long games take (LONGEST first by default — see the sort notes).

An empty result means nothing matched — invalid filter values are rejected before the request is sent, so a zero-row answer is trustworthy.

Page a library query to exhaustion and return a compact list of every match. Use when you need to reason over the entire set — 'which of my backlog are space sims', 'which are good co-op games' — rather than a single page. Narrow with filters first where you can: a genre filter can turn nine requests into one. Reports how many pages were fetched and whether the cap truncated the result.

Discover games by sort order and filters rather than by title — 'popular RPGs from 2022', 'highest rated on Switch'. Filters use Backloggd's own slugs.

A user's chronological play journal — what they played, when, on which platform.

The lists a user has created, with game counts.

The games in a single list, paginated.

Community reviews for a game, with ratings, authors and like counts.

Reviews written by a user. Defaults to your own.

A user's public profile: bio, favourite games, and counts of games played and backlogged.

Every game by a developer or publisher, with YOUR shelf and rating attached to each one — 60 per request, no follow-up lookups. Good for 'which FromSoftware games haven't I played' and for franchise gap-hunting: browse the publisher, then look for the entries you don't have. Company slugs come from get_game's developers field or the company links on a game page.

Games related to one game — its series, DLC, editions, mods or bundles — each with your own shelf state attached. Answers 'does this have a remaster or DLC I don't own'. Note that 'series' follows IGDB's collection grouping, which is narrower than a marketing franchise: Call of Duty's series is the classic-era games, while Modern Warfare and Black Ops are separate collections. For whole-franchise questions use browse_company on the publisher instead.

Platforms, genres, year, rating and playtime for a set of games. COSTS ONE REQUEST PER GAME, so keep batches small and prefer query_library when the set is really a library query (that is one request for the whole page). Use this for sets that are not a library query — most often the contents of a custom list, e.g. 'which of my VR list are on Quest 3'. Results are cached for six hours, so follow-up questions over the same games are nearly free.

Find games across your shelves AND all your custom lists at once, annotated with where each one came from. Answers questions of the form 'in my backlog or any list, which are X'. Needed because list pages do not support filters — the shelf half is filtered server-side, the list half is gathered and filtered locally. Costs one request per list page plus one per shelf page, so it is heavier than query_library; use that instead when you only care about shelves.

Your dated play sessions for a game — when you played, for how long, and any notes or tags. These sit inside each playthrough and are what the journal view is built on.

Recent notifications on your account.

Recent activity: what friends have been playing, rating and reviewing ('friends'), your own actions ('you'), or things others did to your content ('inbound').

Who a user follows, or who follows them. Returns the numeric user ids that set_follow_user needs.

Logs of a game by the community, optionally friends-only or filtered by rating. Set username to read one person's full log history for that game instead (every replay).

Find Backloggd users by name. Pair with get_follows to get numeric ids.

The accepted values for platform and genre filters. Useful when a filter was rejected, or to check whether a platform exists before querying. Filters accept plain names too ('PS5', 'Meta Quest 3') — this is for when you want the exact list.

Move a game to one of your shelves: played, playing, backlog or wishlist. Use 'none' to take it off all shelves without deleting your rating, review or logs. Safe to call repeatedly — it reads the current state and only changes what differs.

Set how you finished a played game: completed, retired, shelved, abandoned, or plain played. The game must already be on your played shelf.

Rate a game from 0.5 to 5 stars, in half-star steps. This is the same scale shown on the site — do not pass Backloggd's internal 1-10 value.

Toggle the heart on a game.

Write a full log for a game: rating, review text, completion status, play dates and playtime. Omitted fields keep their current values, and shelves you do not mention are preserved. Pass playthrough_id to edit an existing log instead of adding one.

Add a game to lists and/or remove it from others in one call. List ids come from get_lists.

Create a new, empty game list. Use add_game_to_lists afterwards to populate it.

Follow or unfollow another Backloggd user by their numeric user id.

Toggle your like on someone's review.

Record that you played a game on a particular date, with optional duration and a note — the building block of a play journal. Attaches to an existing playthrough; get_play_sessions lists their ids. Existing sessions and shelf state are preserved.

Set the order of a list's entries, and optionally a note on each. Pass the FULL ordered set of entry ids — anything omitted may be dropped. Entry ids come from get_list. Most useful for ranked lists.

Pin a game to the favourites row on your profile. Backloggd allows five; adding a sixth is rejected by the site. Removing one is only possible through profile settings on the website, so this server does not offer it.

Save review text as a draft without publishing it. The draft is account-wide (not per game) — it is the scratch buffer behind the site's review editor. Use log_game to actually publish a review against a game.

Post a PUBLIC comment on someone's review or list, under your username. Because this is visible to other people and not something you can quietly undo, it requires confirmation: call once without a token to see exactly what would be posted and where, show that to the user, and only proceed with their agreement.

Delete your rating for a game, keeping the game in your library. Requires confirmation: call once without a token to see what would be removed.

Delete a single playthrough log, including its review and any journal sessions attached to it. Requires confirmation: call once without a token to see what would be deleted.

IRREVERSIBLE. Wipes everything you have for this game: every log and playthrough, your review, your rating, tracked playtime, library entries and like status. Backloggd offers no undo. Requires confirmation — call once without a token to get a full inventory of what will be destroyed, show it to the user, and only proceed with their explicit agreement.

IRREVERSIBLE. Deletes an entire list and everything in it. Requires confirmation — call once without a token to see the list name and how many games it holds.

IRREVERSIBLE. Deletes one of your comments. Requires confirmation.