---
title: "Search section titles"
method: GET
path: "/api/find_sections"
tags: ["rest"]
---

# Search section titles

`GET /api/find_sections`

## Request

- Base URL: `https://masnavi.ai`
- URL: `https://masnavi.ai/api/find_sections`
- Auth: none declared

Find named sections by Persian title. Returns matching sections with slugs and beyt-global ranges. Combine with /api/range to fetch the full text of a multi-section story.

## Query parameters

- `q` string, required: Persian phrase to match against section titles
- `daftar` integer, nullable
- `limit` integer

## Response `200`

Successful Response

- FindSectionsResponse
  - `query` string, required
  - `total` integer, required
  - `sections` SectionMatch[]
    - `id` integer, required
    - `slug` string, required
    - `title_fa` string, required
    - `daftar` integer, required
    - `order_in_parent` integer, required
    - `first_beyt_global` integer, nullable
    - `last_beyt_global` integer, nullable
    - `first_citation` string, nullable
    - `last_citation` string, nullable
    - `beyt_count` integer
    - `match` string, nullable
    - `score` number, nullable
  - `note` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/masnavi/apis/masnavi-ai.md) · [All operations](https://skmtc.dev/masnavi/apis/masnavi-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/masnavi/apis/masnavi-ai/revisions/2622163d327c?raw)