---
title: "Buscar Produtos por Nome"
method: GET
path: "/products-by-name"
tags: ["Produtos"]
---

# Buscar Produtos por Nome

`GET /products-by-name`

Pesquisa produtos pelo nome utilizando fuzzy search, possibilitando encontrar resultados mesmo com variacoes, erros de digitacao ou correspondencias parciais. A consulta e paginada.

## Query parameters

- `term` string, required
- `page` integer
- `size` integer

## Response `200`

Busca realizada com sucesso

- ProductSearchByNameResponse
  - `term` string — Termo utilizado na busca
  - `products` ProductSearchItem[] — Lista de produtos encontrados
    - `id` string, uuid — Identificador unico do produto
    - `name` string — Nome do produto
    - `description` string — Descricao do produto
    - `similarityScore` number — Score de similaridade com o termo buscado (0 a 1)
  - `pagination` Pagination
    - `page` integer — Pagina atual
    - `size` integer — Quantidade de itens por pagina
    - `totalItems` integer — Total de itens encontrados
    - `totalPages` integer — Total de paginas
    - `hasNextPage` boolean — Indica se existe uma proxima pagina
    - `hasPreviousPage` boolean — Indica se existe uma pagina anterior

---

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