# Buscar documentación por API

Encontrá artículos y secciones por título, encabezados y contenido.

URL: https://docs.sempre.ar/integradores/buscar-documentacion
ID: buscar-documentacion
Audiencia: integradores
Modalidad: ambos
Revisión editorial: 2026-10-13

## Antes de empezar

- Un cliente HTTP que procese respuestas JSON.

## Hacé una consulta [#consulta]

Enviá `GET /api/search?q=cerrar%20caja&limit=8`. `q` es obligatorio, admite hasta 120 caracteres y se recorta en los extremos. `limit` es opcional: un entero entre 1 y 20; el valor predeterminado es 8.

La búsqueda ignora mayúsculas y tildes, y reconoce equivalencias curadas como “existencias” y “stock”. Consulta los títulos, los encabezados y el texto de las guías. No consulta información del negocio.

## Interpretá la respuesta [#respuesta]

La respuesta JSON incluye `query`, `results` y `total`. Cada resultado tiene `id`, `title`, `description`, `topic`, `url`, `markdownUrl`, `section` y `snippet`. La URL apunta al artículo o a la sección coincidente. `total` cuenta las secciones coincidentes antes de aplicar el límite.

`results: []` con HTTP 200 significa que la consulta es válida y no encontró coincidencias. Podés reformularla o explorar los temas del manifiesto.

## Tratá los errores [#errores]

Una consulta vacía, demasiado larga, con parámetros repetidos o con un límite inválido devuelve HTTP 400. Un fallo del servicio devuelve HTTP 503 y un mensaje genérico. No interpretes un error como una búsqueda sin resultados.

Solo se admite lectura: los métodos de escritura devuelven HTTP 405. No hacen falta credenciales. No envíes contraseñas, datos personales, tickets ni información privada en una consulta pública.

## Comprobá el resultado

Una consulta devuelve referencias a artículos públicos y sus secciones; una consulta sin coincidencias devuelve una lista vacía.

## Seguí con estas guías

- [Leer documentación desde un asistente](https://docs.sempre.ar/integradores/documentacion-maquinas)
- [Disponibilidad de API y MCP](https://docs.sempre.ar/integradores/estado-conectores)