FullDatasets
Datasets
Use cases Docs
Sign up
Docs

API reference

Bulk download

GET /v1/datasets/books/releases/latest

Release manifest and parquet URLs.

Markdown Full spec OpenAPI

Manifest plus time-limited download URLs for parquet files. Same Bearer key as the rest of the API. No MCP tool.

Resale of the dataset is prohibited. Dumps are for your own systems.

Request

curl -sS -H "Authorization: Bearer $FDS_API_KEY" \
  https://api.fulldatasets.com/v1/datasets/books/releases/latest

Response `200`

{
  "release": "2026-09.2",
  "schema_version": "books.v1",
  "created_at": "…",
  "manifest": {},
  "downloads": {
    "manifest.json": { "url": "https://api.fulldatasets.com/v1/datasets/books/releases/2026-09.2/files/manifest.json", "expires_in": 3600 },
    "books.parquet": { "url": "…", "expires_in": 3600 },
    "changes.parquet": { "url": "…", "expires_in": 3600 },
    "redirects.parquet": { "url": "…", "expires_in": 3600 }
  }
}

Fetch each downloads.*.url with the same Authorization header. URLs expire in 3600 seconds. File route:

GET /v1/datasets/books/releases/{release}/files/{file}

File Contents
manifest.json Release metadata
books.parquet Denormalized bulk table
changes.parquet Changelog snapshot
redirects.parquet Retired id → surviving id

404 if no release is loaded or the file name is unknown.

See also