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

# Busca

> Busca full-text sobre o conteúdo publicado da marca.

Busca (case-insensitive) sobre `title`, `metaDescription` e `body` dos itens **publicados** da
marca. Resultados com correspondência no título vêm primeiro. Ideal para a busca on-site do seu
próprio build.

`GET /cd/search`

<ParamField query="key" type="string" required>
  Sua chave de API de conteúdo (ou header `x-api-key`).
</ParamField>

<ParamField query="q" type="string" required>
  O termo de busca. Mínimo de **2 caracteres** — termos menores retornam vazio.
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl "https://api.citou.me/cd/search?q=gravata&key=SUA_CHAVE"
  ```

  ```js JavaScript theme={null}
  const { results } = await fetch(
    `https://api.citou.me/cd/search?q=${encodeURIComponent(term)}&key=${key}`,
  ).then((r) => r.json());
  ```
</CodeGroup>

```json Resposta theme={null}
{
  "query": "gravata",
  "results": [
    {
      "type": "product",
      "slug": "gravata-slim-azul",
      "title": "Gravata Slim Azul",
      "metaDescription": "Gravata slim de seda azul",
      "publishedAt": "2026-07-25T14:00:00.000Z"
    }
  ]
}
```

<Note>
  A busca retorna uma lista enxuta (até 20 itens). Para o conteúdo completo de um resultado, chame
  [`/cd/content/{slug}`](/api/conteudo).
</Note>