# Найти строки

Поиск по тексту книги: ё = е, без ударений.

`GET /books/{book_id}/search` · чтение

Ищет фразу или все слова в одной строке. До 200 совпадений.

## Параметры пути

| Параметр | Что это |
|---|---|
| `book_id` | Id книги |

## Параметры запроса

| Параметр | Тип | Что это |
|---|---|---|
| `q` | строка | Что искать |

## Что в ответе

| Поле | Что это |
|---|---|
| `hits[]` | `segment_id`, `chapter_id`, `chapter_no`, `line` — номер строки в главе, `text` |
| `total` | Сколько найдено |

```bash
curl "https://golosar-kniga.tech/api/v1/books/$BOOK_ID/search?q=ветер" \
  -H "x-api-key: $KEY"
```

```python
import os, requests

API = "https://golosar-kniga.tech/api/v1"
H = {"x-api-key": os.environ["GOLOSAR_KEY"]}
book_id = "01a134d0-dd73-77be-aa8d-0944ffb2b5e3"

r = requests.get(f"{API}/books/{book_id}/search", headers=H, params={"q": "ветер"})
r.raise_for_status()
print(r.json())
```

```javascript
const API = "https://golosar-kniga.tech/api/v1";
const H = { "x-api-key": process.env.GOLOSAR_KEY };
const bookId = "01a134d0-dd73-77be-aa8d-0944ffb2b5e3";

const r = await fetch(`${API}/books/${bookId}/search?q=${encodeURIComponent("ветер")}`, { headers: H });
if (!r.ok) throw new Error(await r.text());
console.log(await r.json());
```

```json Ответ 200
{
  "q": "ветер",
  "hits": [
    {
      "segment_id": "01a134d0-ddbf-73ed-9fa8-ecf3089fbbbf",
      "chapter_id": "01a134d0-ddb7-72aa-b96c-967b596362fe",
      "chapter": "Глава 1",
      "chapter_no": 1,
      "line": 1,
      "text": "Вечер был тих, и только ветер шумел в саду."
    }
  ],
  "total": 1,
  "chapters": 1
}
```