# BookShops.in — India's Online Bookstore

> BookShops.in is a premium online bookstore based in Madurai, Tamil Nadu, India. We offer 2,000+ curated books across all genres at transparent prices, with FREE shipping on all orders, 15-day easy returns, and Cash on Delivery (COD) available across India.

Founded: 2026
Location: Madurai, Tamil Nadu, India 625001
Contact: support@bookshops.in

---

## Catalogue Overview

- **Total Books:** 2,000+ titles
- **Categories:** 30+ genre categories
- **Languages:** English (primary), with titles in other languages
- **Publishers:** Springer, McGraw-Hill, Pearson, Oxford University Press, and 200+ others

Top categories by volume:
1. Textbooks & Study Guides — 777 books
2. Arts, Film & Photography — 294 books
3. Computers & Internet — 167 books
4. Science & Mathematics — 166 books
5. Business & Economics — 116 books
6. Medicine & Health Sciences — 100 books
7. Exam Preparation (UPSC, JEE, NEET) — 73 books
8. Health, Fitness & Nutrition — 60 books

---

## Public AI-Accessible REST API

All endpoints return JSON-LD (schema.org) format. CORS is fully open.

Base URL: `https://bookshops.in/api/v1`

### Browse Books
`GET /api/v1/books`
Parameters: `page` (default 1), `limit` (default 20, max 100), `category` (slug), `language`
Returns: Paginated ItemList of Book objects with ISBN, authors, publisher, price

### Single Book by ISBN
`GET /api/v1/book/{isbn}`
Accepts ISBN-10 or ISBN-13
Returns: Full Book object with description, authors, publisher, offers

### Authors
`GET /api/v1/authors`
Parameters: `page`, `limit` (max 200)
Returns: ItemList of Person objects with name, URL, book count

### Categories
`GET /api/v1/categories`
Returns: All 30+ genre categories with book counts and icon URLs

### Search
`GET /api/v1/search?q={query}`
Parameters: `q` (title search), `author`, `category`, `limit`
Returns: SearchResultsPage with matching Book objects

### Recommendations
`GET /api/v1/recommendations?isbn={isbn}`
Parameters: `isbn` OR `category` (slug), `limit`
Returns: ItemList of related Book recommendations

---

## Key Pages

- `/` — Homepage with featured books and genre categories
- `/products` — Browse all 2,000+ books
- `/categories` — All genre categories with icons
- `/category/{slug}` — Books in a specific genre
- `/product/{slug}` — Individual book page with full Book schema
- `/author` — All authors index
- `/author/{slug}` — Books by a specific author
- `/publisher` — All publishers index
- `/publisher/{slug}` — Books from a specific publisher
- `/search?q={query}` — Full-text search
- `/sitemap-html` — Human and AI-readable HTML sitemap
- `/sitemap.xml` — XML sitemap

---

## Structured Data

Every page on BookShops.in includes schema.org JSON-LD:
- **Homepage:** Organization, WebSite with SearchAction
- **Product pages:** Book + Product (with ISBN-13, Author/Person, Publisher/Organization, Offer, FAQPage, BreadcrumbList)
- **Category pages:** CollectionPage, BreadcrumbList
- **Author pages:** Person
- **Publisher pages:** Organization

---

## Policies

- **Shipping:** Free on orders above ₹499; ₹49 flat below that
- **Returns:** 15-day hassle-free returns
- **Payment:** All major cards, UPI, net banking, and Cash on Delivery
- **Authenticity:** Only genuine, original books — no pirated copies

---

## Robots & Crawling

- `robots.txt`: Standard crawl permissions; no noindex on catalogue pages
- `sitemap.xml`: Full XML sitemap with all product, category, author, and publisher URLs
- This `llms.txt` file is provided to help AI systems understand the site structure