---
title: "Busca en la base de conocimiento: (1) documentos del negocio (PDFs/CSV que subió), reportes guardados y benchmarks de su industria (la guía de growth de la agencia); y (2) la DOCUMENTACIÓN DE PYMAIA — cómo usar la app (conectar plataformas, qué hace cada módulo, créditos y planes, modo agencia, API/MCP)"
method: POST
path: "/api/v1/search_knowledge"
tags: ["General"]
---

# Busca en la base de conocimiento: (1) documentos del negocio (PDFs/CSV que subió), reportes guardados y benchmarks de su industria (la guía de growth de la agencia); y (2) la DOCUMENTACIÓN DE PYMAIA — cómo usar la app (conectar plataformas, qué hace cada módulo, créditos y planes, modo agencia, API/MCP)

`POST /api/v1/search_knowledge`

## Request

- Base URL: `https://api.pymaia.com`
- URL: `https://api.pymaia.com/api/v1/search_knowledge`
- Auth: HTTP bearer

Busca en la base de conocimiento: (1) documentos del negocio (PDFs/CSV que subió), reportes guardados y benchmarks de su industria (la guía de growth de la agencia); y (2) la DOCUMENTACIÓN DE PYMAIA — cómo usar la app (conectar plataformas, qué hace cada módulo, créditos y planes, modo agencia, API/MCP). USALO antes de recomendar estrategia (para no recomendar de memoria) y SIEMPRE que te pregunten "cómo hago X en Pymaia", "cómo conecto <plataforma>", "qué hace el módulo <Y>" (ahí pasá source_types:["product_docs"]). NO es para métricas en vivo: esas se traen con los query_*/bundles.

## Request body

- object
  - `query` string, required: Qué buscar, en lenguaje natural.
  - `source_types` string[]: Opcional: limitar la búsqueda. product_docs = documentación de cómo usar Pymaia; document/report/industry = conocimiento del negocio y su industria.
  - `limit` number: Máx fragmentos (default 8, techo 20).

## Response `200`

Tool executed successfully

- object
  - `ok` boolean
  - `result` unknown
  - `duration_ms` number

## Other responses

- `400`: Invalid params or handler error
- `401`: Missing or invalid Bearer token
- `403`: Missing required scope(s) (`denied_scope`), or the tool's module is disabled for the organization (`module_disabled`, with `why`, `fix` and `module`)
- `404`: Tool not found, internal-only, or excluded for OAuth connectors
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/pymaia/apis/pymaia-api.md) · [All operations](https://skmtc.dev/pymaia/apis/pymaia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pymaia/apis/pymaia-api/revisions/705a6973177b?raw)