---
title: "Search Goodreads authors dataset"
method: GET
path: "/datasets/goodreads-authors/search"
tags: ["Datasets"]
---

# Search Goodreads authors dataset

`GET /datasets/goodreads-authors/search`

## Request

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

Searches the crawled public Goodreads author profile index. Authors are discovered as a byproduct of the books crawl (every credited book contributor, plus the genre/search/list seed sources) — not a full catalog. Sort enum: `relevance`, `rating_desc`, `reviews_desc`, `name_asc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

## Query parameters

- `q` string
- `name` string
- `genre` string
- `run_id` string
- `min_rating` number
- `min_ratings_count` integer
- `sort` 'relevance' | 'rating_desc' | 'reviews_desc' | 'name_asc'
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsGoodreadsAuthorsSearchResponseDoc
  - `code` integer
  - `data` DatasetsGoodreadsAuthorSearchResponse
    - `dataset` string: Identifier of the dataset queried (`goodreads-authors`).
    - `items` EsGoodreadsAuthorRecord[]: Matching Goodreads author records on this page.
      - `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.
    - `page` integer: Page number returned.
    - `page_size` integer: Number of items per page.
    - `sort` string: Sort order applied.
    - `total` integer: Total number of records matching the filters.
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/0497899e2016?raw)