> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt > Use this file to discover all available pages before exploring further. # Introducción > Recetas de principio a fin para recrear los dashboards de Profound con la API pública. El Cookbook es una colección de **recetas de principio a fin** que muestran cómo recrear cada gráfico, KPI y tabla que ves en la app de Profound usando solo llamadas a la API pública. Cada receta es independiente: enumera los endpoints exactos que usa, explica la forma de la solicitud y muestra código Python y `curl` ejecutable que puedes copiar en tu propio código. Si solo necesitas la referencia de endpoints (cada parámetro, cada métrica), consulta la pestaña [REST API](/es/rest-api/introduction). El Cookbook es la capa que está por encima de eso: las cosas comunes que la gente quiere **construir** con la API. ## Dale contexto a tu asistente de IA ¿Estás desarrollando con Claude, ChatGPT, Cursor u otro asistente de programación con IA? Pega esta URL. Es un índice compacto de cada página de esta documentación que tu asistente puede consultar cuando lo necesite: ``` https://docs.tryprofound.com/llms.txt ``` ## Qué necesitas Genera una en **Settings → API Keys** en la app de Profound. Consulta [Autenticación](/es/rest-api/authentication) si todavía no tienes una. Cada consulta de informes está vinculada a una categoría. Consulta [Encuentra tu ID de categoría](/es/cookbook/setup/find-your-category-id) para buscar uno por nombre. Las recetas usan el SDK de Python por defecto porque es la opción más común. Instálalo con `pip install profound`. Cada receta también tiene una pestaña `curl` si prefieres llamar directamente a la REST API. ## Configuración inicial Cada receta empieza construyendo un cliente como este (solo lo necesitas una vez por script, incluso si encadenas varias recetas): ```python Python theme={null} import os from profound import Profound client = Profound(api_key=os.environ["PROFOUND_API_KEY"]) ``` ```bash curl theme={null} export PROFOUND_API_KEY=your_api_key_here ``` ## Convenciones usadas en todas las recetas Tres cosas que debes tener claras antes de empezar. Aparecen en todas las recetas y confunden a la mayoría de los usuarios nuevos: La API interpreta `end_date` al inicio del día, por lo que **excluye** la fecha que envías. Para incluir todo el `2026-05-10`, envía `end_date="2026-05-11"`. Muestra el valor inclusivo a tus usuarios; envía `+1 day` a la API. Cada respuesta incluye `info.query.metrics` e `info.query.dimensions`, que devuelven el orden exacto que usó la API al empaquetar los arreglos `metrics` y `dimensions` de cada fila. ```python theme={null} order = res.info.query["metrics"] # e.g. ["visibility_score"] i = order.index("visibility_score") score = res.data[0].metrics[i] ``` No codifiques las posiciones de forma fija. El orden puede no coincidir con el que solicitaste. Los cambios entre períodos (el `+1.0 pp` en verde o rojo que ves en cada tarjeta de KPI) se calculan en el cliente. Ejecuta la misma llamada dos veces (una para la ventana actual y otra para la ventana anterior de igual duración) y calcula la diferencia entre ambas puntuaciones en tu código. ## Antes de construir Límites de tasa, fechas de fin exclusivas, orden de `info.query`, errores, paginación. Léelo una vez y pégalo en tu asistente de IA. Cómo se relacionan Categories, Topics, Prompts, Tags, Assets y Personas. Cada endpoint, sus métricas y dimensiones, y para qué sirve: una página fácil de recorrer. La fórmula detrás de cada métrica, un ejemplo práctico y cómo reproducir cada número desde la Answers API. Los temas, las etiquetas y las marcas se aplican desde tu configuración actual, por lo que editar tu configuración cambia los números históricos. ## Recetas ### Configuración Lista las categorías que tu clave puede ver y elige una de forma programática. Obtén cada activo de una categoría con su indicador `is_owned` y sus dominios. ### Visibilidad La puntuación de un activo para la ventana más el cambio respecto a la ventana anterior. Construye el gráfico de líneas diario, semanal o mensual de un activo. Obtén ambos a la vez. Entiende por qué son llamadas distintas. Clasifica cada activo de una categoría según cualquier métrica de visibilidad. Gráfico de varias líneas de cualquier conjunto de activos elegido manualmente. Desglosa la puntuación de un solo activo según la superficie de IA que respondió. ### Citas Participación de los dominios propios en todas las citas, con el cambio entre períodos. Línea diaria de participación de los dominios propios **y** volumen diario total de citas, ambos a partir de una sola llamada. Cada dominio citado clasificado por participación, con la columna de variación en pp por fila.