# 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](https://fulldatasets.com/#signup).

Export it:

```bash
export FDS_API_KEY='fds_live_…'
```

## 2. Look up an ISBN

```bash
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)

```bash
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](/docs/mcp).

## Next

- [Authentication](/docs/authentication) — header, 401, 429
- [Choose an endpoint](/docs/choose) — ISBN vs match vs search
- [Book object](/docs/data-model) — fields you will keep seeing