Quickstart

Get a book back in one request.

1. Get a key

Keys look like fds_live_<kid>_<secret>. They are issued manually in v1 — request access.

Export it:

export FDS_API_KEY='fds_live_…'

2. Look up an ISBN

curl -sS -H "Authorization: Bearer $FDS_API_KEY" \
  https://api.fulldatasets.com/v1/isbn/9780593135204

You should see Project Hail Mary, authors: ["Andy Weir"], and a description.

Hyphens are fine. ISBN-10 0593135202 resolves to the same edition.

3. Resolve a title (no ISBN)

curl -sS -H "Authorization: Bearer $FDS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Project Hail Mary","author":"Andy Weir"}' \
  https://api.fulldatasets.com/v1/match

Take candidates[0]. That is the canonical edition for the title.

4. Connect an agent

Same key, MCP endpoint https://mcp.fulldatasets.com/mcp. See Connect MCP.

Next

• Authentication — header, 401, 429
• Choose an endpoint — ISBN vs match vs search
• Book object — fields you will keep seeing