GEO Writer

Crea y gestiona tareas de GEO Writer con IA. Las tareas se procesan de forma asíncrona, así que crea una y haz polling hasta que se complete.

POST/intelligence_tasks

Crea una tarea de GEO Writer. Hay dos modos: basado en un prompt (indica prompt_id) o agéntico (indica custom_topic y/o user_instructions). El tipo product_listing, en cambio, recibe un objeto product y devuelve textos para la página de producto listos para aplicar.

Cuerpo (JSON):
  • project_idobligatorio
  • task_typeobligatorio: brief, create, update, pr_insights, custom, product_listing
  • prompt_id
  • custom_topic
  • user_instructions
  • output_language_code
  • existing_content
  • existing_content_url

Solo para product_listing: product (obligatorio: title, además de external_id, description_html, seo_title, seo_description, url, product_type y hasta 20 images con id y alt) y prompt_ids (hasta 20 prompts del proyecto a los que orientar los textos). Cuando la tarea se completa, su result_data incluye summary, description_html, faq, seo_title, seo_description, image_alts y changes.

GET/intelligence_tasks

Lista las tareas de GEO Writer de un proyecto con filtrado opcional.

Parámetros:
  • project_idobligatorio
  • task_type
  • status
  • page
  • per_page

GET/intelligence_tasks/:id

Obtén todos los detalles de la tarea, incluidos los datos del resultado una vez completada. Acepta el ID numérico o el public_id.

Parámetros:
  • project_idobligatorio
  • :idID de la tarea o public_id en la URL

PATCH/intelligence_tasks/:id

Edita bloques de texto existentes de una tarea completada sin volver a generarla. Cada clave de edits es una ruta separada por puntos que apunta a un valor de texto de result_data (por ejemplo, sections.0.content) y solo se puede cambiar el texto que ya existe. Un valor idéntico al texto almacenado se ignora, y el primer cambio guarda una copia de la versión generada por la IA para que pueda restaurarse.

Cuerpo (JSON):
  • project_idobligatorio
  • :idID de la tarea o public_id en la URL
  • editsobligatorio, objeto que asocia cada ruta separada por puntos con el texto nuevo

Requiere una clave de API con ámbito de lectura y escritura.

result_version (opcional): envía el result_version devuelto al leer la tarea. Si la tarea se ha vuelto a generar desde entonces, la edición se rechaza con ERR_STALE_CONTENT (HTTP 409) y no se guarda nada: vuelve a leer la tarea y reenvía tus cambios. Si no lo incluyes, los cambios se aplican a lo que contenga la tarea en ese momento.

POST/intelligence_tasks/:id/revert

Descarta todos los cambios manuales y restaura la versión generada por la IA que se guardó con el primer cambio. Devuelve ERR_INVALID_PARAM cuando la tarea no tiene cambios manuales.

Parámetros:
  • project_idobligatorio
  • :idID de la tarea o public_id en la URL

Requiere una clave de API con ámbito de lectura y escritura.