Build with SPINES
Access book collections, search metadata, manage reading lists, and recognize books from bookshelf images — all through a simple REST API.
20 Endpoints
Collections, books, personas, categories, reading lists, and AI-powered recognition.
Free Tier
1,000 reads and 200 writes per day. 10 recognition credits daily. No credit card required.
Test Mode
Separate test and live keys. Test keys return mock data — safe for development.
Quick Start
# List your collections
curl https://getspines.com/api/v1/collections \
-H "Authorization: Bearer gtspn_live_YOUR_KEY"
# Search for books
curl "https://getspines.com/api/v1/books/search?q=sapiens" \
-H "Authorization: Bearer gtspn_live_YOUR_KEY"
# Get book pairings (Shelfology)
curl https://getspines.com/api/v1/books/{id}/pairings \
-H "Authorization: Bearer gtspn_live_YOUR_KEY"