> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morada.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Buscar Produto por Nome

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



## OpenAPI

````yaml GET /products-by-name
openapi: 3.1.0
info:
  title: API Morada.ai
  version: 1.0.0
  description: >-
    Boas-vindas a documentacao da API Morada.ai!


    O escopo dessa documentacao e o cadastro e ingestao de leads dentro da
    M.I.A, com cada metodo tendo sua especificidade detalhada.


    Caso haja duvidas sobre a API, entre em contato direto com nosso time de
    engenharia em team.engineering@morada.ai, ou caso seja uma duvida geral,
    entre em contato com nosso time de atendimento atraves de seu Account
    Manager, ou atraves do e-mail help@morada.ai.
  contact:
    name: Morada.ai Engineering
    email: team.engineering@morada.ai
servers:
  - url: https://mia-gateway.morada.ai
    description: Servidor de producao
security:
  - apiKey: []
tags:
  - name: Deals
    description: Operacoes relacionadas a negocios (deals)
  - name: Leads
    description: Operacoes relacionadas a ingestao de leads
  - name: Notificacoes
    description: Envio de notificacoes e mensagens template via WhatsApp
  - name: Produtos
    description: Consulta e busca de produtos cadastrados
paths:
  /products-by-name:
    get:
      tags:
        - Produtos
      summary: Buscar Produtos por Nome
      description: >-
        Pesquisa produtos pelo nome utilizando fuzzy search, possibilitando
        encontrar resultados mesmo com variacoes, erros de digitacao ou
        correspondencias parciais. A consulta e paginada.
      operationId: searchProductsByName
      parameters:
        - name: term
          in: query
          required: true
          description: Termo de busca para o nome do produto (fuzzy search)
          schema:
            type: string
          example: imovel teste
        - name: page
          in: query
          required: false
          description: 'Numero da pagina (opcional, padrao: 1)'
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: size
          in: query
          required: false
          description: 'Quantidade de itens por pagina (opcional, padrao: 10)'
          schema:
            type: integer
            default: 10
            minimum: 1
      responses:
        '200':
          description: Busca realizada com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductSearchByNameResponse'
              example:
                term: '"imovel teste"'
                products:
                  - id: 84320188-1452-4fe8-900e-3bca9d46fb6c
                    name: '[21] imovel teste'
                    description: teste
                    similarityScore: 1
                pagination:
                  page: 1
                  size: 10
                  totalItems: 1
                  totalPages: 1
                  hasNextPage: false
                  hasPreviousPage: false
      security:
        - apiKey: []
components:
  schemas:
    ProductSearchByNameResponse:
      type: object
      properties:
        term:
          type: string
          description: Termo utilizado na busca
        products:
          type: array
          items:
            $ref: '#/components/schemas/ProductSearchItem'
          description: Lista de produtos encontrados
        pagination:
          $ref: '#/components/schemas/Pagination'
    ProductSearchItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Identificador unico do produto
        name:
          type: string
          description: Nome do produto
        description:
          type: string
          description: Descricao do produto
        similarityScore:
          type: number
          description: Score de similaridade com o termo buscado (0 a 1)
    Pagination:
      type: object
      properties:
        page:
          type: integer
          description: Pagina atual
        size:
          type: integer
          description: Quantidade de itens por pagina
        totalItems:
          type: integer
          description: Total de itens encontrados
        totalPages:
          type: integer
          description: Total de paginas
        hasNextPage:
          type: boolean
          description: Indica se existe uma proxima pagina
        hasPreviousPage:
          type: boolean
          description: Indica se existe uma pagina anterior
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-morada-api-key
      description: Chave de API do parceiro. Fornecida pelo time da Morada.ai.

````