Найти строки

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

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

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

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

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

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

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

Что в ответе

Поле Что это
hits[] segment_id, chapter_id, chapter_no, line — номер строки в главе, text
total Сколько найдено
curl "https://golosar-kniga.tech/api/v1/books/$BOOK_ID/search?q=ветер" \
  -H "x-api-key: $KEY"
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())
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 }