---
title: "Global search"
method: GET
path: "/search/"
tags: ["Search"]
---

# Global search

`GET /search/`

Search across books, authors, and genres with content search

## Query parameters

- `q` string, required
- `locale` 'en' | 'ar'

## Response `200`

Global search results retrieved successfully

- GlobalSearchResponse
  - `content` object, required
    - `total` integer
    - `results` object[]
      - `versionId` string
      - `book` 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
              - …
        - `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
      - `node` object — Search result node
  - `books` object, required
    - `hits` 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
    - `found` integer
  - `authors` object, required
    - `hits` Author[]
      - `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
    - `found` integer
  - `genres` object, required
    - `hits` Genre[]
      - `id` string, required — Unique identifier for the genre
      - `slug` string, required — URL-friendly identifier
      - `name` string, required — Name of the genre
      - `color` string — Color for UI display
      - `pattern` integer — Pattern number for UI display
    - `found` integer

---

[API](https://skmtc.dev/usul/apis/usul-api.md) · [All operations](https://skmtc.dev/usul/apis/usul-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usul/usul-api/revisions/b4f2df3e5842/schema)