API reference
Authors
GET /v1/authors/search
Search by name or get a contributor by fds_au_ id.
Search contributors by name, or get one by FullDatasets id.
MCP: search_authors { "q": "Andy Weir" } — do not put an author-only string into search_books.
Search
curl -sS -H "Authorization: Bearer $FDS_API_KEY" \
"https://api.fulldatasets.com/v1/authors/search?q=Andy%20Weir"
| Query | Required | Notes |
|---|---|---|
q |
yes | Name or prefix |
limit |
no | Default 20, max 50 |
{ "results": [{ "id": "fds_au_…", "name": "Andy Weir", "sort_name": "Weir, Andy" }] }
Prefix and trigram match on contributors.name. This is the path for “books by …” when you do not have a title.
Get by id
You have an fds_au_… id from GET /v1/authors/search or from contributors[].id on a book. authors is still the display-name array.
Request
curl -sS -H "Authorization: Bearer $FDS_API_KEY" \
https://api.fulldatasets.com/v1/authors/fds_au_37316331633930383534
| Path | Required | Notes |
|---|---|---|
id |
yes | Contributor id (fds_au_…) |
Response `200`
{
"id": "fds_au_37316331633930383534",
"name": "Andy Weir",
"sort_name": "Weir, Andy",
"release": "2026-09.2"
}
301— merged contributor; followLocation404— unknown id
Cached 24h after auth.
See also
- Data model
- Search —
author=filter on editions (name, not id) - Match — title + optional author