# Books API
### **Books AI Documentation**
A Books API gives you a structured collection of information about books, including titles, authors, publication details, summaries, images, and sometimes reviews, ratings, and related works. You can use this data to power book-related websites, apps, recommendation engines, or any project that needs organized book information.
## Base URL
The base URL for the Books Details API is:
https://santechapi.vercel.app
### Authentication
```
headers : {
"token" : {YOUR API KEY}
}
```
Endpoint: `/books/search/{:q}`
### Parameters:
* {q}: Book name from the user
*HTTP Method: `Get`*
**Example request:**
```
GET /books/search/Wings of fire
```
*The user can search for the Book with its name and get the details of the the book and its Author*
**Example Response:**
**`200`**
```json
{
"numFound": 315,
"start": 0,
"numFoundExact": true,
"docs": [
{
"author_alternative_name": [
"A.P.J Abdul Kalam",
"A.P.J. Abdul Kalam",
"Avul Pakir Jainulabdeen Abdul Kalam",
"Dr. A.P.J Abdul Kalam",
"A P J Abdul Kalam",
"Abdul A.P.J. Kalam",
"Abdul P. J. Kalam",
"Abul Pakiz Jainulabdeen Abdul Kalam"
],
"author_key": [
"OL101656A"
],
"author_name": [
"A. P. J. Abdul Kalam"
],
"contributor": [
"Tiwari, Arun.",
"National Institute for the Visually Handicapped (India). Kendrīya Brela Presa."
],
"cover_edition_key": "OL155884M",
"cover_i": 9153819,
"ebook_access": "borrowable",
"ebook_count_i": 1,
"edition_count": 6,
"edition_key": [
"OL9081155M",
"OL31996911M",
"OL22487339M",
"OL25448189M",
"OL155884M",
"OL3332247M"
],
"first_publish_year": 1999,
"format": [
"Braille",
"Paperback"
],
"has_fulltext": true,
"ia": [
"isbn_9788173711466"
],
"ia_collection": [
"inlibrary",
"internetarchivebooks",
"printdisabled"
],
"ia_collection_s": "inlibrary;internetarchivebooks;printdisabled",
"isbn": [
"9788173711466",
"8173711461"
],
"key": "/works/OL1037811W",
"language": [
"hin",
"eng"
],
"last_modified_i": 1725625164,
"lcc": [
"Q--0143.00000000.A197 A3 1999"
],
"lccn": [
"99931304",
"2004311162"
],
"lending_edition_s": "OL9081155M",
"lending_identifier_s": "isbn_9788173711466",
"number_of_pages_median": 180,
"oclc": [
"41326410"
],
"osp_count": 466,
"printdisabled_s": "OL9081155M",
"public_scan_b": false,
"publish_date": [
"jan 1999",
"1999",
"2015",
"2002",
"2007"
],
"publish_place": [
"Hyderabad",
"Deharādūna, Uttarāñcala",
"Hyderabad, A.P., India"
],
"publish_year": [
2002,
2007,
1999,
2015
],
"publisher": [
"AK Publisher",
"Distributed by Orient Longman",
"sangam books limited",
"Kendrīya Brela Praisa, Rāshṭrīya Dr̥shṭibādhitārtha Saṃsthāna, Samājika Nyāya evaṃ Adhikāritā Mantrālaya, Bhārata Sarakāra ke adhīna",
"Universities Press"
],
"seed": [
"/books/OL9081155M",
"/books/OL31996911M",
"/books/OL22487339M",
"/books/OL25448189M",
"/books/OL155884M",
"/books/OL3332247M",
"/works/OL1037811W",
"/authors/OL101656A",
"/subjects/biography",
"/subjects/presidents",
"/subjects/scientists",
"/subjects/person:a._p._j._abdul_kalam_(1931-)",
"/subjects/person:avul_pakir_jainulabdeen_abdul_kalam",
"/subjects/place:india"
],
"title": "Wings of Fire",
"title_sort": "Wings of Fire",
"title_suggest": "Wings of Fire",
"type": "work",
"id_goodreads": [
"634583",
"634583",
"634583"
],
"id_librarything": [
"1375619",
"1375619",
"1375619"
],
"subject": [
"Biography",
"Presidents",
"Scientists"
],
"place": [
"India"
],
"person": [
"A. P. J. Abdul Kalam (1931-)",
"Avul Pakir Jainulabdeen Abdul Kalam"
],
"ratings_average": 4.382353,
"ratings_sortable": 4.049073,
"ratings_count": 68,
"ratings_count_1": 5,
"ratings_count_2": 2,
"ratings_count_3": 3,
"ratings_count_4": 10,
"ratings_count_5": 48,
"readinglog_count": 1505,
"want_to_read_count": 1274,
"currently_reading_count": 170,
"already_read_count": 61,
"publisher_facet": [
"AK Publisher",
"Distributed by Orient Longman",
"Kendrīya Brela Praisa, Rāshṭrīya Dr̥shṭibādhitārtha Saṃsthāna, Samājika Nyāya evaṃ Adhikāritā Mantrālaya, Bhārata Sarakāra ke adhīna",
"Universities Press",
"sangam books limited"
],
"person_key": [
"a._p._j._abdul_kalam_(1931-)",
"avul_pakir_jainulabdeen_abdul_kalam"
],
"place_key": [
"india"
],
"person_facet": [
"A. P. J. Abdul Kalam (1931-)",
"Avul Pakir Jainulabdeen Abdul Kalam"
],
"subject_facet": [
"Biography",
"Presidents",
"Scientists"
],
"_version_": 1809449134838513700,
"place_facet": [
"India"
],
"lcc_sort": "Q--0143.00000000.A197 A3 1999",
"author_facet": [
"OL101656A A. P. J. Abdul Kalam"
],
"subject_key": [
"biography",
"presidents",
"scientists"
]
}],
"num_found": 315,
"q": "Wings of fire",
"offset": null
}
```
### Error Handling:
In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.
**Error Response:**
**`402`**
```
{
message: "param required for keyword based Books fetch."
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://santech.gitbook.io/docs/books-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.