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.
project_idobligatoirereport_typeobligatoire : crawlability, schema, content_readiness, discoverability, site_structure, robots_txt, agent_readiness, llms_txt, ai_visibilitystatusbatch_idpageper_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’iddu 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.
project_idobligatoireurlobligatoirecountry_codefacultatif, pays du projet par défautoutput_language_codefacultatif, langue ISO 639-1 dans laquelle les fichiers llms.txt sont rédigés, langue du projet par défaut ;autoconserve la langue du site et est renvoyé sous la formeauto; 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 valoirllms_txt),content_version(obligatoire, chaîne),edits(obligatoire, objet avecllms_txtet/oullms_full_txt, chacun contenant le nouveau fichier complet, non vide et de 200 000 caractères au maximum) et l’identifiantiddu 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 valoirllms_txt) et l’identifiantiddu 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.