The VerseDB API is a RESTful interface for browsing comic data and managing your personal library — collection, pull list, lists, read status, follows. Anyone with a verified VerseDB account can generate a token and start using it.
Use it to build personal tools, Discord bots, mobile apps, reading trackers, analytics dashboards, or automate your own data management.
Basics#
- Base URL:
https://versedb.com/api - Auth: Bearer token (Laravel Sanctum). Every endpoint requires authentication.
- Response format: JSON
- Full reference: versedb.com/api/docs
Rate Limits#
| Tier | Read (GET) | Write (POST/PUT/DELETE) |
|---|---|---|
| Free | 300/hour | 150/hour |
| PRO | 1,000/hour | 500/hour |
What You Can Access#
Free tier — list and detail endpoints for publishers, titles, series, issues, characters, creators, story arcs, teams, universes, comic shops, and podcasts. Plus discovery endpoints like featured issues and upcoming first appearances.
PRO tier — relationship endpoints (series → issues/creators/characters, issues → variants/creators/characters, teams → characters/series/issues) and market data (listings, price snapshots, overview).
Authenticated user features — managed through scoped tokens:
| Scope | Grants |
|---|---|
read:public |
Public catalog data (default) |
read:user |
Your own profile and account data |
lists:follow |
Follow/unfollow titles, characters, podcasts |
lists:pulllist |
Manage your pull list |
lists:collection |
Read your collection |
lists:read |
Track reading progress |
lists:user_lists |
Create and manage user lists and wishlist |
Getting Started#
- Log in to VerseDB
- Go to Settings → API Tokens
- Create a token with the scopes you need (principle of least privilege)
- Copy it immediately — it's only shown once
- Send it as
Authorization: Bearer YOUR_TOKENwith every request
See Authentication & API Tokens for examples and security best practices.