---
title: "Search Categories"
method: GET
path: "/v1/categories/search"
tags: ["v1"]
---

# Search Categories

`GET /v1/categories/search`

Search categories by free-text query.

## Query parameters

- `query` string, required — Free-text query (e.g. 'sofas', 'yoga mats').
- `limit` integer — Maximum number of categories to return.

## Response `200`

Successful Response

- SearchCategoriesResponse
  - `categories` CategorySummary[], required — Categories matching the query, ordered by relevance.
    - `slug` string, required — URL-friendly slug (e.g. 'sofas')
    - `title` string, required — Human-readable category title
    - `path` CategoryRef[] — Hierarchical path as a structured list, root first; the last entry is this category itself
      - `slug` string, required — URL-friendly slug (e.g. 'sofas')
      - `title` string, required — Human-readable category title
    - `has_children` boolean, required — Whether this category has subcategories

## Other responses

- `401` — Unauthorized - Invalid or missing authentication
- `402` — Payment required
- `422` — Validation Error
- `500` — Internal Server Error

## Changes

- **2026-05-21** `48ea59b2e819` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/channel3-ai/apis/fastapi/changes/v1/categories/search/get.md)

---

[API](https://skmtc.dev/channel3-ai/apis/fastapi.md) · [All operations](https://skmtc.dev/channel3-ai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/channel3-ai/fastapi/revisions/981d371bd83e/schema)