Prompts

Las preguntas que lanzamos a los modelos de IA cada semana y los registros de ejecución que genera cada ejecución.

GET /dimensions/prompts

Lista los prompts de un proyecto.

Parámetros:

• project_id obligatorio
• collection_id
• prompt ID de prompt
• country_code
• language_code
• from
• to
• page
• per_page ≤ 100

GET /dimensions/prompt_executions

Lista las ejecuciones de prompt de un proyecto.

Parámetros:

• project_id obligatorio
• model
• collection_id
• prompt ID de prompt
• country_code
• language_code
• from
• to
• page
• per_page
• mention_filter
• citation_filter
• competitors la matriz de dos ejes descrita en GET /answers

GET /dimensions/query_fan_outs

Las subconsultas que un modelo emitió realmente al responder a tus prompts monitorizados, útiles para descubrir la redacción que los modelos buscan en lugar de la redacción que escribiste tú. view=query (por defecto) devuelve una fila por subconsulta distinta con su recuento y su proporción sobre el total de apariciones; view=prompt devuelve una fila por prompt con el número de subconsultas distintas que generó. El fan-out lo reporta principalmente ChatGPT, así que un resultado vacío suele significar que los modelos consultados no lo exponen.

Parámetros:

• project_id obligatorio
• view query o prompt
• query subcadena del texto de la subconsulta
• order
• direction
• model
• collection_id
• prompt
• country_code
• language_code
• prompt_type
• brand_kind
• range
• from
• to
• page
• per_page
• output

POST /prompts

Crea hasta 100 prompts por solicitud. Los prompts existentes (mismo texto + locale) se omiten.

Cuerpo (JSON):

• project_id obligatorio
• prompts array, obligatorio, máx. 100
• country_code obligatorio
• language_code obligatorio

DELETE /prompts/:id

Elimina un prompt. Es irreversible; el prompt desaparece de inmediato, libera un hueco de prompt y un trabajo en segundo plano purga su historial (ejecuciones, menciones, citaciones, sentimiento). Requiere una clave de API con permisos de escritura.

Parámetros:

• project_id obligatorio
• :id en la URL

Devuelve ERR_NOT_FOUND para prompts fuera del proyecto.

Acceso completo. Cancela cuando quieras.