List books

Books API›Books

GEThttps://api.example.com/v1/books

Description

Returns a paginated list of books.

Request

cURLJavaScriptPython

Copy

curl "https://api.example.com/v1/books?limit=20&cursor=string"

const response = await fetch("https://api.example.com/v1/books?limit=20&cursor=string");

import requests

response = requests.get(
    "https://api.example.com/v1/books",
    params={
      "limit": "20",
      "cursor": "string"
    },
)

Response200JSONCopy

{
  "data": [
    {
      "id": "bk_9f8a7c21",
      "title": "The Pragmatic Programmer",
      "author": "Andrew Hunt",
      "published_year": 1999,
      "tags": [
        "software",
        "craft"
      ]
    },
    {
      "id": "bk_3b2c1d04",
      "title": "Structure and Interpretation of Computer Programs",
      "author": "Harold Abelson",
      "published_year": 1985,
      "tags": [
        "computer-science",
        "classic"
      ]
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjIwfQ"
}

Parameters

limitqueryintegerdefault: 20

Maximum number of books to return (1-100).

cursorquerystring

Opaque pagination cursor from a previous response.

Responses

200A page of books.application/json

dataobject[]

next_cursorstring | null

Cursor for the next page, or null when done.