---
title: "Hybrid search across commentary entries"
method: GET
path: "/commentary/search"
tags: ["Commentary"]
---

# Hybrid search across commentary entries

`GET /commentary/search`

## Request

- Base URL: `https://api.holydb.com/v1`
- URL: `https://api.holydb.com/v1/commentary/search`
- Auth: none declared

Keyword + vector search over entry text, with book and author facets.

## Query parameters

- `q` string
- `book` string: Exact book name filter, e.g. `John`.
- `author` string: Exact author filter, e.g. `Augustine`.

## Response `200`

Matching entries, best match first, with facet counts

- CommentarySearchResponse
  - `total` number, required
  - `hits` CommentarySearchHit[], required
    - `id` string, required
    - `workTitle` string, required
    - `bookName` string, required
    - `chapter` number, required
    - `verseStart` number, required
    - `verseEnd` number, required
    - `author` string, nullable, required
    - `text` string, required
  - `facets` object, required
    - `books` FacetCount[], required
      - `value` string, required
      - `count` number, required
    - `authors` FacetCount[], required
      - `value` string, required
      - `count` number, required

## Other responses

- `400`: Missing q

---

[API](https://skmtc.dev/holydb/apis/holydb-api.md) · [All operations](https://skmtc.dev/holydb/apis/holydb-api/llms.txt) · [OpenAPI document](https://skmtc.dev/holydb/apis/holydb-api/revisions/7b5ce0171598?raw)