Rapports GEO techniques

Lancez le lot GEO technique pour une URL, puis listez, interrogez et récupérez chaque rapport. Les rapports s’exécutent de façon asynchrone. Le rapport de préparation aux agents d’IA (Agent Readiness, parfois appelé AI readiness) utilise report_type=agent_readiness.

GET/technical_geo_reports

Liste les rapports d’un même type de GEO technique pour un projet, du plus récent au plus ancien. Utilisez cet endpoint pour trouver les ID et le statut des rapports avant de récupérer un résultat complet.

Paramètres :
  • project_idobligatoire
  • report_typeobligatoire : crawlability, schema, content_readiness, discoverability, site_structure, robots_txt, agent_readiness, llms_txt, ai_visibility
  • status
  • batch_id
  • page
  • per_page100 maximum

GET/technical_geo_reports/:id

Renvoie le statut actuel d’un rapport. Pendant son exécution, poll_after_seconds vaut 15. Un rapport terminé inclut result_data ; un rapport en échec inclut error_message. Un rapport llms.txt terminé renvoie aussi result_data.content_version, la valeur qu’une modification doit renvoyer, et metadata.output_language_code, ainsi que manually_edited_at et les originaux générés dès que les fichiers ont été modifiés dans l’application, via l’API ou via le MCP. Un output_language_code à null signifie que les fichiers llms.txt conservent la langue du site.

  • Paramètres : project_id (obligatoire), report_type (obligatoire) et l’id du rapport dans l’URL.

POST/technical_geo_reports

Lance le lot GEO technique complet (neuf rapports) pour une URL et un pays. Le lot ne démarre que s’il reste au moins neuf unités quotidiennes. Chaque rapport créé avec succès consomme une unité ; un rapport qui n’est pas créé n’en consomme aucune. Les allocations quotidiennes varient selon le compte. Chaque rapport s’exécute dans une tâche en arrière-plan. La réponse contient report_ids, indexé par type de rapport, et invite le client à interroger régulièrement chaque identifiant via l’endpoint de détail du rapport. Nécessite une clé API de portée read_write.

Corps (JSON) :
  • project_idobligatoire
  • urlobligatoire
  • country_codefacultatif, pays du projet par défaut
  • output_language_codefacultatif, langue ISO 639-1 dans laquelle les fichiers llms.txt sont rédigés, langue du projet par défaut ; auto conserve la langue du site et est renvoyé sous la forme auto ; les autres rapports du lot ne sont pas concernés

PATCH/technical_geo_reports/:id/content

Remplace les fichiers llms.txt et llms-full.txt d’un rapport llms.txt terminé, sans le générer de nouveau. edits contient le nouveau texte complet d’un fichier ou des deux, et content_version doit être égal au result_data.content_version du rapport lors de votre dernière lecture. Si le rapport a changé entre-temps, la modification est refusée avec ERR_INVALID_PARAM : récupérez-le de nouveau, puis renvoyez la modification. Un fichier identique au texte enregistré est ignoré, et la première modification conserve les fichiers générés pour pouvoir les restaurer. changed_files liste les fichiers modifiés et reste vide si rien n’a changé.

  • Corps (JSON) : project_id (obligatoire), report_type (obligatoire, doit valoir llms_txt), content_version (obligatoire, chaîne), edits (obligatoire, objet avec llms_txt et/ou llms_full_txt, chacun contenant le nouveau fichier complet, non vide et de 200 000 caractères au maximum) et l’identifiant id du rapport dans l’URL. Nécessite une clé API avec droit d’écriture et, pour les membres de l’équipe, l’autorisation de création sur les audits GEO.

POST/technical_geo_reports/:id/revert_content

Annule toutes les modifications manuelles d’un rapport llms.txt et restaure les fichiers générés conservés lors de la première modification. manually_edited_at, original_llms_txt_content et original_llms_full_txt_content repassent à null, et content_version change. Renvoie ERR_INVALID_PARAM si le rapport ne comporte aucune modification manuelle.

  • Corps (JSON) : project_id (obligatoire), report_type (obligatoire, doit valoir llms_txt) et l’identifiant id du rapport dans l’URL. Nécessite une clé API avec droit d’écriture et, pour les membres de l’équipe, l’autorisation de création sur les audits GEO.