Example: List books
Paginate and filter your catalog with the List books endpoint — page, perPage, format, language, and sort.
See the interactive reference for List books. This page shows common GET /books query patterns against staging.
Replace YOUR_API_KEY with your API key. Responses depend on your imprint and data.
See also
- Get a book — detail for one title after you have an id from this list.
- Full upload walkthroughs: Ebook, Audiobook, Print on demand.
First page (default sort)
curl -sS -G "https://api.sandbox.dev.publishdrive.com/v2/distribution/books" \
-H "apikey: YOUR_API_KEY" \
--data-urlencode "page=1" \
--data-urlencode "perPage=20" \
--data-urlencode "sort=createdAt"Filter by format and language
curl -sS -G "https://api.sandbox.dev.publishdrive.com/v2/distribution/books" \
-H "apikey: YOUR_API_KEY" \
--data-urlencode "page=1" \
--data-urlencode "perPage=50" \
--data-urlencode "format=ebook" \
--data-urlencode "language=EN" \
--data-urlencode "sort=title"