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.
project_idobligatoriotask_typeobligatorio: brief, create, update, pr_insights, custom, product_listingprompt_idcustom_topicuser_instructionsoutput_language_codeexisting_contentexisting_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.
project_idobligatoriotask_typestatuspageper_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.
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.
project_idobligatorio:idID de la tarea o public_id en la URLeditsobligatorio, 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.
project_idobligatorio:idID de la tarea o public_id en la URL
Requiere una clave de API con ámbito de lectura y escritura.