# Buscar en la documentación (/es/api/assistant/search)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1002 · updated: 2026-07-30 -->
Related: [Crear mensaje de assistant](/es/api/assistant/create-assistant-message-v2.md), [Obtener contenido de la página](/es/api/assistant/get-page-content.md)

<div id="rate-limits">
  ## Límites de tasa [#límites-de-tasa]
</div>

* 10,000 solicitudes por organización de Mintlify por hora

`POST /v1/search/{domain}`

Realiza búsquedas semánticas y por palabras clave en tu documentación, con filtrado y paginación configurables.

Autentícate con una clave de API del assistant. Las solicitudes de búsqueda no consumen créditos.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "domain",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "El identificador domain de tu URL `domain.mintlify.site`. Lo puedes encontrar al final de la URL de tu dashboard. Por ejemplo, `dashboard.mintlify.com/organization/domain` tiene un identificador domain de `domain`."
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "query"
          ],
          "properties": {
            "query": {
              "type": "string",
              "description": "La búsqueda que se ejecutará en el contenido de tu documentación."
            },
            "pageSize": {
              "type": "integer",
              "default": 10,
              "minimum": 1,
              "maximum": 50,
              "description": "Número de resultados de búsqueda que se mostrarán. Debe estar entre 1 y 50. De forma predeterminada es 10 si no se especifica."
            },
            "scoreThreshold": {
              "type": "number",
              "minimum": 0,
              "maximum": 1,
              "description": "Puntuación mínima de relevancia para los resultados. Solo se devuelven los resultados con una puntuación igual o superior a este umbral. Debe estar entre 0 y 1."
            },
            "filter": {
              "type": "object",
              "description": "Parámetros de filtrado opcionales para restringir los resultados de la búsqueda.",
              "properties": {
                "version": {
                  "type": "string",
                  "description": "Filtra los resultados por versión de la documentación."
                },
                "language": {
                  "type": "string",
                  "description": "Filtra los resultados por idioma del contenido."
                },
                "tag": {
                  "type": "string",
                  "description": "Filtrar resultados por etiqueta."
                },
                "groups": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Grupos de documentación opcionales a los que el llamador está autorizado a acceder. Cuando la implementación usa `auth` o `userAuth`, los resultados se limitan a las páginas que los grupos especificados pueden ver. Si se omite o está vacío en una implementación protegida, los resultados se limitan a las páginas públicas."
                }
              }
            }
          }
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Resultados de la búsqueda",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "content": {
                  "type": "string",
                  "description": "El contenido de tu documentación que coincide con la búsqueda."
                },
                "path": {
                  "type": "string",
                  "description": "La ruta o URL del documento de origen."
                },
                "metadata": {
                  "type": "object",
                  "description": "Metadata adicional sobre el resultado de la búsqueda."
                }
              }
            }
          }
        }
      }
    }
  }
}
```