---
title: "Get homepage section books"
method: GET
path: "/book/sections/{section}"
tags: ["Books"]
---

# Get homepage section books

`GET /book/sections/{section}`

## Request

- Base URL: `https://api.usul.ai`
- URL: `https://api.usul.ai/book/sections/{section}`
- Auth: none declared

Retrieve the books for a homepage section

## Path parameters

- `section` 'popular' | 'islamic-law' | 'islamic-history', required

## Query parameters

- `locale` 'en' | 'ar'

## Response `200`

Section books retrieved successfully

- Book[]
  - `id` string, required: Unique identifier for the book
  - `slug` string, required: URL-friendly identifier
  - `primaryName` string, required: Primary name of the book
  - `secondaryName` string: Secondary name of the book
  - `author` Author, required
    - `id` string, required: Unique identifier for the author
    - `slug` string, required: URL-friendly identifier
    - `primaryName` string, required: Primary name of the author
    - `secondaryName` string: Secondary name of the author
    - `year` integer: Year of birth/death
    - `locations` Location[]
      - `id` string, required: Unique identifier for the location
      - `name` string, required: Name of the location
      - `region` Region
        - `id` string, required: Unique identifier for the region
        - `slug` string, required: URL-friendly identifier
        - `name` string, required: Name of the region
  - `year` integer: Year of publication
  - `versions` BookVersion[]
    - `id` string, required: Unique identifier for the version
    - `value` string, required: Version identifier
    - `source` string, required: Source of the version
    - `aiSupported` boolean: Whether AI is supported for this version
    - `keywordSupported` boolean: Whether keyword search is supported

## Changes

- **2026-09-22** `c97a31c24e55`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usul/apis/usul-api/changes/book/sections/:section/get.md)

---

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