Datasets

Facet Goodreads books dataset

Returns terms aggregation counts for the Goodreads books dataset. Facet enum: genres, format, language, publisher, primary_author, primary_author_id, series_name, publication_year, run_id.

get/datasets/goodreads-books/facets

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/goodreads-books/facets
  • Auth: API key in header x-api-key

Query parameters

facet'genres' | 'format' | 'language' | 'publisher' | 'primary_author' | 'primary_author_id' | 'series_name' | 'publication_year' | 'run_id' required

Facet enum: genres, format, language, publisher, primary_author, primary_author_id, series_name, publication_year, run_id

qstring

Full-text query over title, author and description, max 256 characters

genrestring

Exact genre filter, max 128 characters

formatstring

Exact format filter, max 128 characters

languagestring

Exact language filter, max 128 characters

publisherstring

Exact publisher filter, max 128 characters

authorstring

Exact author name filter, max 128 characters

author_idstring

Exact Goodreads author id filter, max 128 characters

seriesstring

Exact series name filter, max 128 characters

isbnstring

Exact ISBN-10 filter, max 128 characters

isbn13string

Exact ISBN-13 filter, 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

min_pagesinteger

Minimum page count

max_pagesinteger

Maximum page count

min_publication_yearinteger

Minimum publication year

max_publication_yearinteger

Maximum publication year

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.