Find books matching the search criteria. Does not require authentication.
Parameters
genre
string
Optional
Filter by genre. Returns books in that genre. Can be used with or without q.
id
string
Optional
The ID of the book within the hive.
limit
integer
Optional
No description available.
offset
integer
Optional
Offset for pagination into the result set
q
string
Optional
Search query string. Will be matched against title and authors fields.
Output
application/jsonbooks
array
Required
No description available.
offset
integer
Optional
The next offset to use for pagination (result of limit + offset)
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"type": "query",
"output": {
"schema": {
"type": "object",
"required": [
"books"
],
"properties": {
"books": {
"type": "array",
"items": {
"ref": "buzz.bookhive.hiveBook#main",
"type": "ref"
}
},
"offset": {
"type": "integer",
"description": "The next offset to use for pagination (result of limit + offset)"
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"required": [],
"properties": {
"q": {
"type": "string",
"description": "Search query string. Will be matched against title and authors fields."
},
"id": {
"type": "string",
"description": "The ID of the book within the hive."
},
"genre": {
"type": "string",
"description": "Filter by genre. Returns books in that genre. Can be used with or without q."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"description": "Offset for pagination into the result set"
}
}
},
"description": "Find books matching the search criteria. Does not require authentication."
}