Crawlora icon

Crawlora

Get structured web data from the public web via the Crawlora API

Actions166

Datasets → Datasets Goodreads Authors Search

AI-generated

Summary

Search the Goodreads authors dataset using text, author name, genre, crawl run ID, rating, and ratings-count filters. Choose a sort order and page settings to retrieve matching authors.

Inputs

  • Q — Full-text query across author name, about text, and genres; maximum 256 characters.
  • Name — Exact author name filter; maximum 128 characters.
  • Genre — Exact genre filter, such as Fantasy, Romance, or Nonfiction; maximum 128 characters.
  • Run Id — Exact crawl run ID filter; maximum 128 characters.
  • Min Rating — Minimum average rating from 0 through 5; defaults to 0.
  • Min Ratings Count — Minimum number of ratings; defaults to 0.
  • Sort — Sort order: relevance (default), rating descending, reviews descending, or name ascending.
  • Page — Page number; the UI default is 0 and the description says the API defaults to 1.
  • Page Size — Results per page; the UI default is 0 and the description says the API defaults to 20, with a maximum of 100. Page multiplied by page size must not exceed 10,000.
  • X Api Key (required) — API key sent in the x-api-key request header.
  • Request Options — Optional request controls for batching, SSL certificate validation, an HTTP proxy, and timeout.

Output shape

A single API response containing Goodreads author search results.

Results are paginated using Page and Page Size. The supplied source pack does not include this operation's request or response handling, so the exact response fields and envelope are unspecified.

Examples

Example 1: Fetch one author record

Set the Name filter to the exact author name and use the default relevance sort.

Example 2: Find highly rated authors in a genre

Set Genre, choose a Min Rating, and sort by Rating Desc.

Example 3: Search broadly across author details

Enter Q to search names, about text, and genres, then adjust Page and Page Size to navigate results.

Links

Discussion