> ## 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.

# Endpoints de un vistazo

> Todos los endpoints de la API de Profound, sus métricas/dimensiones/filtros clave y para qué sirven: una sola página fácil de recorrer.

Oriéntate en 30 segundos. Cada fila es un endpoint; haz clic para ver
la referencia completa de parámetros. Para un contexto más profundo sobre las convenciones
(fechas, ordenación, paginación), consulta [Convenciones y trampas comunes](/es/cookbook/setup/conventions).

## Organización y configuración

| Método | Ruta | Úsalo para |
| - | - | - |
| `GET` | `/v1/org/categories` | Listar todas las categorías que tu clave puede ver. |
| `GET` | `/v1/org/categories/{id}/assets` | Activos de una categoría, con `is_owned` + dominios. |
| `GET` | `/v1/org/categories/{id}/topics` | Temas configurados para la categoría. |
| `GET` | `/v1/org/categories/{id}/tags` | Etiquetas configuradas. |
| `GET` | `/v1/org/categories/{id}/personas` | Personas configuradas. |
| `GET` | `/v1/org/regions` | Regiones habilitadas en tu organización. |
| `GET` | `/v1/org/models` | Modelos de IA (ChatGPT, Claude, etc.) habilitados en tu organización. |
| `GET` | `/v1/org/domains` | Dominios que posee tu organización. |
| `GET` | `/v1/org/personas` | Personas habilitadas en tu organización. |

## Informes

Los endpoints de informes de Answer Engine Insights son solicitudes `POST` con ámbito de
`category_id` y devuelven la estructura `{info, data}`. Los informes de visibilidad, citas,
sentimiento y query-fanouts aceptan `category_id`, `start_date`,
`end_date` y `metrics`, además de campos opcionales específicos de cada informe.

Los informes de tráfico usan una estructura diferente: bots y referencias tienen como ámbito
`domain` en lugar de `category_id`. Los informes de FactCheck V2 y las respuestas de
prompts V2 tienen ámbito de categoría y fecha, pero no aceptan un campo `metrics`.

### `/v1/reports/visibility`

Con qué frecuencia aparece tu activo en las respuestas de IA.

| Métricas | Dimensiones | Filtros comunes |
| - | - | - |
| `visibility_score`, `share_of_voice`, `average_position`, `mentions_count`, `executions` | `date`, `asset_name`, `model`, `region`, `persona`, `topic`, `tag` | `asset_name`, `model_id`, `region_id`, `persona_id`, `topic_id`, `tag_id` |

Recetas comunes: [Visibility Score (con delta)](/es/cookbook/visibility/asset-visibility-score),
[a lo largo del tiempo](/es/cookbook/visibility/visibility-over-time),
[clasificación](/es/cookbook/visibility/leaderboard),
[comparar competidores](/es/cookbook/visibility/compare-competitors),
[segmentar por modelo/región/persona](/es/cookbook/visibility/segment-by-model).

### `/v1/reports/citations`

Qué URL y dominios citan las respuestas de IA.

| Métricas | Dimensiones | Filtros comunes |
| - | - | - |
| `count`, `citation_share` | `date`, `root_domain`, `url`, `citation_category`, `model`, `region`, `persona` | `prompt_type` (p. ej., `"visibility"`), `model_id`, `region_id`, `persona_id` |

Recetas comunes: [Citation Share + delta](/es/cookbook/citations/citation-share),
[cuota + volumen a lo largo del tiempo](/es/cookbook/citations/citation-share-over-time),
[clasificar por dominio](/es/cookbook/citations/top-citing-domains).

<Note>
  `citation_share` se promedia por modelo de IA. `count` es el número bruto.
  Ordenar por uno no sigue al otro. Elige la pregunta que estás
  respondiendo y ordena por la métrica correspondiente.
</Note>

### `/v1/reports/sentiment`

Qué tan positiva o negativamente hacen referencia las respuestas de IA a tu activo.

| Métricas | Dimensiones | Filtros comunes |
| - | - | - |
| `positive`, `negative`, `occurrences` | `date`, `asset_name`, `theme`, `sentiment_type`, `topic`, `model`, `region`, `persona` | `asset_name`, `theme`, `topic_id`, `model_id`, `region_id`, `persona_id` |

<Warning>
  Los números del endpoint público de sentimiento actual no coincidirán exactamente con el
  valor principal de la app de Profound. Sentiment v2, que cierra esa
  diferencia, se lanzará pronto.
</Warning>

### `/v1/reports/query-fanouts`

La vista de query-fanout (cómo los prompts se propagan en cascada por las superficies de IA). La misma
estructura `{info, data}`.

### `/v1/reports/referrals` (y `/v2/reports/referrals`)

Tráfico de referencias humanas a tus dominios atribuido a respuestas de IA.

### `/v1/reports/bots` (y `/v2/reports/bots`)

Tráfico de rastreadores / bots de IA a tus dominios.

### `/v2/reports/factcheck` y `/v2/reports/factcheck/claims`

Puntuaciones de FactCheck y afirmaciones inexactas de una categoría. Estos endpoints aceptan
`category_id`, `start_date` y `end_date`, pero no `metrics`.

## Respuestas (datos por prompt)

| Método | Ruta | Úsalo para |
| - | - | - |
| `POST` | `/v1/prompts/answers` | Obtener las respuestas de IA sin procesar para los prompts de una categoría. |
| `POST` | `/v2/prompts/answers` | Obtener filas de respuestas sin procesar por ejecución para una categoría. |

## Agents

| Método | Ruta | Úsalo para |
| - | - | - |
| `GET` | `/v1/agents` | Listar los agents configurados. |
| `GET` | `/v1/agents/{id}` | Obtener la configuración de un agent. |
| `POST` | `/v1/agents/{id}/runs` | Iniciar una nueva ejecución de un agent. |
| `GET` | `/v1/agents/{id}/runs/{run_id}` | Consultar el estado de una ejecución. |

## Prompts

| Método | Ruta | Úsalo para |
| - | - | - |
| `GET` | `/v1/org/categories/{id}/prompts` | Listar los prompts de una categoría. |
| `POST` | `/v1/org/categories/{id}/prompts` | Añadir un prompt. |
| `PATCH` | `/v1/org/categories/{id}/prompts` | Editar prompts. |
| `PATCH` | `/v1/org/categories/{id}/prompts/status` | Habilitar/deshabilitar prompts. |

## Content Optimization

| Método | Ruta | Úsalo para |
| - | - | - |
| `GET` | `/v1/content/{asset_id}/optimization` | Oportunidades de optimización para un activo. |
| `GET` | `/v1/content/{asset_id}/optimization/{content_id}` | Una optimización en detalle. |

***

Para la referencia canónica de parámetros (todos los operadores, todos los campos,
obligatorios frente a opcionales), consulta la pestaña [REST API](/es/rest-api/introduction).