search

Search Json

Performs a search for documents based on the provided query.

get/search.json

Request

  • Base URL: https://openlibrary.org (the document declares no server; this is the origin it was published from)
  • URL: https://openlibrary.org/search.json
  • Auth: none declared

Query parameters

limitinteger

Maximum number of results to return.

offsetinteger nullable

Number of results to skip.

pageinteger nullable

Page number (1-indexed).

qstring

The search query string.

titlestring nullable
publisherstring nullable
oclcstring nullable
lccnstring nullable
contributorstring nullable
subjectstring nullable
placestring nullable
personstring nullable
timestring nullable
has_fulltext'true' | 'false' nullable
public_scan_bstring[]
public_scan'true' | 'false' nullable
print_disabled'true' | 'false' nullable
author_keystring[]

Filter by author key.

subject_facetstring[]

Filter by subject.

person_facetstring[]

Filter by person. Not the author but the person who is the subject of the work.

place_facetstring[]

Filter by place.

time_facetstring[]

Filter by time. It can be formatted many ways.

first_publish_yearstring[]

Filter by first publish year.

publisher_facetstring[]

Filter by publisher.

languagestring[]

Filter by language using three-letter language codes.

[
  "eng"
]
author_facetstring[]

(alias for author_key) Filter by author key.

isbnstring nullable
authorstring nullable
fieldsstring[]

The fields to return.

queryobject nullable

A full JSON encoded solr query.

sortstring nullable

The sort order of results.

spellcheck_countinteger nullable

The number of spellcheck suggestions.

Response

Successful Response

numFoundinteger required
startinteger required
numFoundExactboolean required
num_foundinteger required
documentation_urlstring
qstring required
offsetinteger nullable required
docsobject[]

Changes

No recorded changes to this operation across all 1 revision of this API.