📚 Book Search API

A Django REST API project that allows users to search books using Google Books API, store them in a PostgreSQL database, and manage favorite books.

🔧 Features

• 🔍 Search books via Google Books API (/api/books/search/?q=...)
• 📦 Store results in PostgreSQL
• 🧠 Query local database (/api/books/local/)
• ⚡ API caching (avoid duplicate external calls)
• 🔐 Token-based authentication
• ❤️ Add/remove favorite books (per user)

🚀 Tech Stack

• Python 3.11
• Django 5
• Django REST Framework
• PostgreSQL
• Docker & Docker Compose

🛠 Setup Instructions

1. Clone the repo

git clone https://github.com/ychanyzh/book-search.git
cd book-search

2. Create .env file

POSTGRES_DB=booksearch
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_HOST=db
POSTGRES_PORT=5432

3. Build and run with Docker

docker compose build
docker compose up

4. Apply migrations and create superuser

docker compose run web python manage.py migrate
docker compose run web python manage.py createsuperuser

🔑 Authentication

Get Token:

POST /api/token/
Content-Type: application/x-www-form-urlencoded

username=yourusername&password=yourpassword

Use in requests:

Authorization: Token your_token_here

📚 Endpoints Summary

Method	Endpoint	Description
GET	/api/books/search/?q=...	Search books from Google API
GET	/api/books/local/	Search books from local DB
GET	/api/books/favorites/	List user's favorite books
POST	/api/books/favorites/	Add book to favorites { "book": ID }
DELETE	/api/books/favorites/<id>/	Remove favorite book

🧑‍💻 Author

Yaroslav Chanyzh

📄 License

MIT — feel free to use and modify.