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

# Search empires

`GET /search/empires`

Search for empires with optional sorting

## Query parameters

- `q` string
- `limit` integer
- `page` integer
- `sortBy` 'relevance' | 'texts-asc' | 'texts-desc' | 'authors-asc' | 'authors-desc' | 'alphabetical-asc' | 'alphabetical-desc'
- `locale` 'en' | 'ar'

## Response `200`

Search results retrieved successfully

- EmpireSearchResponse
  - `results` object, required
    - `hits` Empire[]
      - `id` string, required — Unique identifier for the empire
      - `slug` string, required — URL-friendly identifier
      - `name` string — Primary name of the empire
      - `secondaryName` string — Secondary name of the empire
      - `overview` string — Overview description of the empire
      - `numberOfAuthors` integer, required — Number of authors associated with this empire
      - `numberOfBooks` integer, required — Number of books associated with this empire
    - `found` integer
  - `pagination` object, required
    - `page` integer
    - `perPage` integer
    - `totalPages` 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)