VerseDB: Comic Book Tracker

Get your reading progress for a series. Shows which issues you have read, completion percentage, and unread issues.

get-series-progress-tool

Get full details for one VerseDB entity by type and ID. Types: "title" = a franchise; "series" = a specific volume/run (includes publishers, genres, stats, and where to buy/read); "issue" = a single publication (includes creators with roles, characters, key issue reasons, variants, story arcs, and where to buy/read); plus creator, character, publisher, team, story_arc, universe, event, comic_shop, podcast, and "list" (a curated user list with its items). For "comic_shop", operating_hours is keyed Monday-first by lowercase day name; a day absent from that map has unknown hours rather than being closed.

get-tool

Get trending and top-rated comic series from VerseDB based on community reviews and ratings.

get-trending-tool

Get upcoming comic releases: issues with a release date or FOC (Final Order Cutoff) date in the next N days, soonest first, a page at a time. pull_list_only narrows it to the series on your active pull list.

get-upcoming-releases-tool

Manage your curated lists. New lists are published and public by default; set is_private=true for a private list. Updating privacy or publication status can expose a list to other users. Operations: create a list; update its title/description/privacy/ranking; delete it (wishlists cannot be deleted); add_item / remove_item to change its contents; merge one of your lists into another; open_to_any_type so a single-type list can hold anything (one-way); stop_rule_updates to drop the rule on a smart list and keep its current items, editable by hand from then on (one-way — a rule is only attached at creation). create requires title and takes no type — every list made here holds any combination of types; add_item requires list_id + entity_id plus entity_type and takes an optional variant_id to pin one cover variant — issues only, must belong to that issue, omit for "any cover"; remove_item requires list_id + item_id (the item_id of an entry on that list); merge requires destination_list_id + source_list_id.

list-tool

Find a comic issue by a scanned barcode — a UPC (the printed barcode on most single issues) or an ISBN (common on trade paperbacks and hardcovers). Pass the digits read off the barcode. UPCs are NOT unique in comics: pre-1995 issues and reprints can share one, so a single barcode may resolve to several issues — in that case this returns a list of candidates to disambiguate against the cover.

lookup-by-barcode-tool

Manage your pull list (series you follow for new releases). operation=add starts tracking a series and notifies you of new issues; operation=remove stops tracking it.

pull-list-tool

Track your reading progress. operation=mark_read marks an issue as read (optionally with the variant you read); operation=mark_unread removes the read status.

read-status-tool

Publish or edit your community review of a comic issue, or rate a whole series. Reviews and ratings contribute to community content and are not private notes. operation=create with issue_id writes a new issue review (rating required, text optional; one per issue per user, and the issue must already be released). operation=create with series_id rates the series: stars only, no text, and rating a series you already rated changes that rating. operation=update edits your existing review (requires review_id). Ratings are 1-5 in half-star increments.

review-tool

Search VerseDB by entity type. Set "type" to what you are looking for: "title" = a franchise (e.g. Batman); "series" = a specific volume/run (e.g. Batman (2016)); "issue" = a single publication; plus creator, character, publisher, team, story_arc, universe, event (conventions/store events), comic_shop, podcast. Filters only apply to certain types and are ignored otherwise: publisher_id (series, title, character), medium/status/start_year (series), series_id/release_date_from/release_date_to (issue), role_id (creator), event_type/upcoming/country_code (event), country (comic_shop).

search-tool