Lire les résultats d’un crawl
Anomalies, pages et rapports d’un crawl, et la comparaison avec le précédent.
Le résumé des anomalies
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/issues/summary" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"Le résumé rend les familles d’anomalies avec leur nombre d’occurrences et les totaux par gravité. Les constats qui décrivent une page de pare-feu ou d’interstitiel, et non le site, sortent de tous les totaux ; leur nombre est rendu à part (protection_occurrences).
Les occurrences, filtrées
Une ligne par anomalie et par URL, filtrable par gravité, catégorie ou nom :
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/issues?severity=error&limit=50" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"Les pages
La liste des pages crawlées, ou une page précise par son URL :
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/pages/by-url?url=https%3A%2F%2Fexemple.fr%2F" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"Les rapports
Chaque crawl porte des rapports figés : pagespeed, geo, accessibility, eeat et structure. Chacun déclare son status (ready, pending ou unavailable) et la version du barème qui l’a produit :
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/geo" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"Un rapport absent n’est jamais rendu en zéros : score: null veut dire « non mesuré ».
Comparer au crawl précédent
curl "https://api.nessflow.com/v1/crawls/$CRAWL_ID/compare" \
-H "Authorization: Bearer $NESSFLOW_TOKEN"Sans paramètre, la référence est le crawl comparable précédent du même projet. Un crawl tronqué n’en est jamais une : quand aucune référence n’existe, l’API répond 404 crawl.no_baseline.