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

# Search authors

`GET /search/authors`

Search for authors with various filters

## Query parameters

- `q` string
- `limit` integer
- `page` integer
- `regions` string
- `empires` string
- `yearRange` string
- `ids` string
- `sortBy` 'relevance' | 'year-asc' | 'year-desc' | 'texts-asc' | 'texts-desc' | 'alphabetical-asc' | 'alphabetical-desc'
- `locale` 'en' | 'ar'

## Response `200`

Search results retrieved successfully

- AuthorSearchResponse
  - `results` 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 — Total number of results found
  - `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)