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_idobligatorio
  • collection_id
  • promptID 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_idobligatorio
  • model
  • collection_id
  • promptID de prompt
  • country_code
  • language_code
  • from
  • to
  • page
  • per_page
  • mention_filter
  • citation_filter
  • competitorsla 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_idobligatorio
  • viewquery o prompt
  • querysubcadena 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_idobligatorio
  • promptsarray, obligatorio, máx. 100
  • country_codeobligatorio
  • language_codeobligatorio

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_idobligatorio
  • :iden la URL

Devuelve ERR_NOT_FOUND para prompts fuera del proyecto.