📝 doc: Update README.md

Author: nmdra

README.md

@@ -1,4 +1,4 @@
-# Semantic Book Search with Go, pgvector, and Gemini API
+# Semantic Book Search with Go, pgvector, and Gemini API <img src="https://github.com/egonelbre/gophers/blob/master/.thumb/animation/gopher-dance-long.gif?raw=true" alt="Gopher Dancing" width="30"/>
 
 [![Release with GoReleaser](https://github.com/nmdra/Semantic-Search/actions/workflows/release.yaml/badge.svg)](https://github.com/nmdra/Semantic-Search/actions/workflows/release.yaml)
 [![golangci-lint](https://github.com/nmdra/Semantic-Search/actions/workflows/golangci-lint.yaml/badge.svg)](https://github.com/nmdra/Semantic-Search/actions/workflows/golangci-lint.yaml)
@@ -58,9 +58,23 @@ C4Context
 
 ### API Endpoints
 
-* `POST /books` — Add a book with title and description; stores embedding in DB
-* `GET /search?q=your+query` — Search books semantically by query text
-* `GET /ping` — Health check endpoint
+* **`POST /books`**
+  Add a new book by providing its title and description. The service generates and stores a semantic embedding of the description in the database.
+
+* **`GET /search?q=your+query`**
+  Perform a semantic search on the stored books using the query text. Returns a list of matching books ranked by relevance.
+
+* **`GET /ping`**
+  Simple health check endpoint to verify if the service is running.
+
+#### Example Usage
+
+Search for books related to *Science fiction that describe Social Hierarchy*:
+
+```bash
+curl -sG "http://localhost:8080/search" --data-urlencode "q=Science fiction that describe Social Hierarchy" | jq
+```
+<img width="1331" height="705" alt="image" src="https://github.com/user-attachments/assets/d11a4a23-1260-4809-8416-bcf2986f5154" />
 
 ### Setup PostgreSQL