JustSERPDocs
Google

Google Books

Google's Books tab for a query: books, magazines or newspapers with their authors, year and where the words were found.

GET
/v1/google/books

Google's Books tab for a query: books, magazines or newspapers with their authors, year and where the words were found. Answers the document: search_metadata, search_parameters, search_information, organic_results (id, title, link, authors, date, extensions, found_in, snippet, other_links, thumbnail) and pagination. The tab takes no device and no location. Magazine and newspaper results have no authors. Desktop only.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

What to search for.

Length1 <= length
gl?string

Country of the search, two letters.

Default"us"
hl?string

Interface language, e.g. en, pt-br.

Default"en"
safe?string

Adult-content filtering.

Default"blur"
Value in"active""blur""off"
document?string

books (bkt:b), magazines (bkt:m), newspapers (bkt:w).

Default"books"
Value in"books""magazines""newspapers"
view?string

How much of the book is viewable (bkv:a|p|f).

Value in"any_view""preview_and_full_view""full_view"
time_period?string

Century of publication. Not with a range.

Value in"21century""20century""19century"
time_period_min?string

Start of a date range, MM/DD/YYYY.

Match^\d{2}/\d{2}/\d{4}$
time_period_max?string

End of a date range, MM/DD/YYYY.

Match^\d{2}/\d{2}/\d{4}$
page?integer

Results page; Google's start is (page - 1) * 10.

Range1 <= value <= 100
Default1

Response Body

The results page, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The Books document. A block is present only when the page has it.

search_metadata?
search_parameters?

The request as sent, with the defaults that were used.

search_information?
organic_results?array<>
pagination?
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/books?q=Python'
Example Response
{  "search_metadata": {    "id": "string",    "status": "string",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {    "query_displayed": "string"  },  "organic_results": [    {      "position": 0,      "id": "string",      "title": "string",      "link": "string",      "authors": [        {          "name": "string",          "link": "string"        }      ],      "date": "string",      "extensions": [        "string"      ],      "found_in": "string",      "snippet": "string",      "thumbnail": "string",      "other_links": [        {          "title": "string",          "link": "string"        }      ]    }  ],  "pagination": {    "current": 0,    "previous": "string",    "next": "string",    "other_pages": [      {        "page": 0,        "link": "string"      }    ]  }}