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#
The catalog is free. Any authenticated token can read list and detail endpoints for publishers, titles, series, issues, characters, creators, story arcs, teams, universes, comic shops, and podcasts. The same goes for relationship endpoints (series to issues, creators, characters; issues to variants, creators, characters; teams to characters, series, issues) and the two discovery endpoints, /api/discovery/foc and /api/discovery/upcoming-firsts.
What PRO changes is your rate limit, not your reach. Market data is not on the public API at all — it serves the VerseDB mobile apps only.
Authenticated user features — managed through scoped tokens:
| Scope | Grants |
|---|---|
read:public |
Public catalog data (default) |
read:user |
Your own profile and account data |
write:follows |
Follow/unfollow titles, characters, podcasts |
write:pull-list |
Manage your pull list |
write:collection |
Add, update, and remove collection entries |
write:read-status |
Mark issues read or unread |
write:list |
Create and manage your lists |
write:wishlist |
Add and remove wishlist issues |
lookup:barcode |
Look up an issue by barcode |
Getting Started#
- Log in to VerseDB
- Go to My Apps
- 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.