Informes técnicos de GEO

Ejecuta el conjunto de informes GEO técnicos para una URL; después, lista, consulta el estado y recupera cada informe. Los informes se procesan de forma asíncrona. El informe de preparación para agentes, que a veces se denomina preparación para IA, usa report_type=agent_readiness.

GET/technical_geo_reports

Lista los informes más recientes de un tipo de informe GEO técnico para un proyecto. Usa este endpoint para localizar los identificadores y el estado de los informes antes de recuperar un resultado completo.

Parámetros:
  • project_idobligatorio
  • report_typeobligatorio: crawlability, schema, content_readiness, discoverability, site_structure, robots_txt, agent_readiness, llms_txt, ai_visibility
  • status
  • batch_id
  • page
  • per_pagemáximo 100

GET/technical_geo_reports/:id

Consulta el estado actual de un informe. Mientras se procesa, poll_after_seconds es 15. Un informe completado incluye result_data; un informe fallido incluye error_message.

  • Parámetros: project_id (obligatorio), report_type (obligatorio) y el id del informe en la URL.

POST/technical_geo_reports

Ejecuta el conjunto completo de análisis GEO técnicos para una URL y un país. Cada informe se procesa como una tarea en segundo plano. La respuesta incluye report_ids, organizados por tipo de informe, e indica al cliente que consulte cada identificador mediante el endpoint de detalle del informe.

Cuerpo (JSON):
  • project_idobligatorio
  • urlobligatorio
  • country_codeopcional, por defecto el país del proyecto