Datasets

Search Goodreads authors dataset

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).

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

Query parameters

qstring

Full-text query over name, about and genres, max 256 characters

namestring

Exact author name filter, max 128 characters

genrestring

Exact genre filter (e.g. Fantasy, Romance, Nonfiction), max 128 characters

run_idstring

Exact crawl run-id filter, max 128 characters

min_ratingnumber

Minimum average rating, 0 through 5

min_ratings_countinteger

Minimum number of ratings

sort'relevance' | 'rating_desc' | 'reviews_desc' | 'name_asc'

Sort enum: relevance, rating_desc, reviews_desc, name_asc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.