Everything you need to know about using the VerseDB API. Learn how to authenticate, explore endpoints, manage rate limits, and build tools with your data.
Articles in VerseDB API Guide
Getting Started with the VerseDB API
A REST API for catalog data and your own library. Free tokens get 300 reads an hour, PRO 1,000, with scopes you pick per token.
Authentication & API Tokens
Create a scoped Bearer token, copy it once (it's never shown again), and send it on every request. Includes cURL, JS, and Python examples.
Understanding API Rate Limits on VerseDB
Free tokens get 300 reads and 150 writes an hour; PRO gets 1,000 and 500. Watch X-RateLimit-Remaining and back off when you hit a 429.
Exploring API Endpoints & Structure
The URL patterns behind every VerseDB API route: list, detail, nested PRO relationships, and actions, plus the response envelope and pagination.
API Endpoint Quick Reference
Every VerseDB API endpoint in one table: free catalog reads, PRO nested and market routes that return 402 without a subscription, and account writes.
Best Practices for Using the VerseDB API
Cache catalog data, honor Retry-After on a 429, use PRO nested routes instead of loops, and keep tokens out of client-side code.
Troubleshooting Common API Errors
What 400, 401, 402, 403, 404, 422, and 429 mean on the VerseDB API, and the numeric-ID gotcha behind most 404s.
What's Not Available in the API
Some features on VerseDB are web-only by design. Which ones, why, and where to do each of them instead.