---
title: "Get a Goodreads author from dataset"
method: GET
path: "/datasets/goodreads-authors/items/{id}"
tags: ["Datasets"]
---

# Get a Goodreads author from dataset

`GET /datasets/goodreads-authors/items/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/goodreads-authors/items/{id}`
- Auth: API key in header `x-api-key`

Returns one Goodreads author from the dataset by numeric author `id`. The record has name, about text, genres, birth and death dates, website, average rating, ratings and reviews counts, image and Goodreads URL. An id not in the dataset returns 404.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsGoodreadsAuthorResponseDoc
  - `code` integer
  - `data` EsGoodreadsAuthorRecord
    - `about` string: Author biography from the Goodreads page.
    - `average_rating` number: Average rating across the author's books on Goodreads.
    - `birth_date` string: Birth date as Goodreads shows it, for example `August 11, 1962`.
    - `crawled_at` string: Time the author's data was fetched, in UTC (RFC 3339).
    - `death_date` string: Date of death as Goodreads shows it.
    - `discovery_source` string: DiscoverySource records how this id was found, e.g. "book:2767052", "genre:fantasy", "search:mystery" — useful for crawl provenance/debugging.
    - `genres` string[]: List of genres Goodreads shows for the author.
    - `id` string: Goodreads author id.
    - `image_url` string: URL of the author's photo.
    - `name` string: Full name of the author.
    - `ratings_count` integer: Number of ratings the author's books have received.
    - `reviews_count` integer: Number of reviews the author's books have received.
    - `run_id` string: Identifier of the collection run that produced this record. Accepted as a `run_id` filter.
    - `schema_version` integer: Version of the record layout.
    - `seed_rank` integer: SeedRank is the discovery priority (lower = discovered earlier/higher priority), mirroring GoodreadsBookRecord.SeedRank.
    - `source_url` string: URL the data was read from.
    - `uri` string: Link to the author's Goodreads page.
    - `website` string: Author's website address.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)